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PREFACE 


This user's guide describes the Query Update 
Version 3.4 language, which is designed for data 
storage and retrieval operations. Query Update 
operates under control of the following operating 
systems: 

NOS 1 for the CONTROL DATA® CYBER 170 Computer 

Systems; CYBER 70 Computer System models 71, 

72, 73, 74; 6000 Computer Systems 

NOS 2 for the CDC® CYBER 170 Computer Systems; 

CYBER 70 Computer System models 71, 72, 73, 74; 

6000 Computer Systems 


NOS/BE 1 for the CDC CYBER 170 Computer Sys¬ 
tems; CYBER 70 Computer System models 71, 72, 
73, 74; 6000 Computer Systems 

The Query Update language supports a wide variety 
of applications ranging from simple data file query 
to complex report production. This guide is orga¬ 
nized by application; directives are introduced as 
they become appropriate. Some feature enhancements 
are not available to the NOS 1 user; these enhance¬ 
ments are noted in the guide. 


Sections 1 through 5 discuss file concepts and 
directives that apply to data access and manipula¬ 
tion. Section 6 details report writing facilities 
and directives that apply to report catalog main¬ 
tenance and production. Section 7 presents opera¬ 
tions within a multiple-file data base environment. 
Section 8 illustrates special Query Update utility 
operations. All data base access is described for 
use with CYBER Record Manager. 

This guide is designed for programmers who are 
familiar with Control Data standard software 
products. The Query Update reference manual should 
be consulted for additional information regarding 
the Query Update language. 

Related material is contained in the following 
publications. The NOS 1, NOS 2, and NOS/BE 1 
manual abstracts are pocket-sized manuals contain¬ 
ing brief descriptions of the contents and intended 
audience of all NOS 1 and NOS 1 product set manuals, 
NOS 2 and NOS 2 product set manuals, and NOS/BE 1 
and NOS/BE 1 product set manuals, respectively. 
The abstract manuals can be used to determine which 
manuals are of greatest interest. The Software 
Publications Release History can be used to deter¬ 
mine which revision level of software documentation 
corresponds to the Programming System Report (PSR) 
level of installed site software. 


The following manuals are of primary interest: 


Publication 


Publication 

Number 

NOS 1 

NOS 2 

NOS/BE 1 

Query Update Version 3 Reference Manual 

60498300 

X 

X 

X 

Query Update Version 3 User's Guide 

For Use With: CYBER Record Manager 

60387700 

X 

X 

X 

following manuals are of secondary interest: 




Publication 

Publication 

Number 

NOS 1 

NOS 2 

NOS/BE 1 

CYBER Record Manager Advanced Access 
Methods Version 2 Reference Manual 

60499300 

X 

X 

X 

CYBER Record Manager Basic Access 

Methods Version 1.5 Reference Manual 

60495700 

X 

X 

X 

DMS-170 Query Update/CYBER Record 

Manager Data Administration 

Reference Manual 

60482100 

X 

X 

X 

INTERCOM Version 5 Reference Manual 

60455010 



X 

Network Products 

Interactive Facility Version 1 

Reference Manual 

60455250 

X 
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Publication 




Publication 

Number 

NOS 1 

NOS 2 

NOS/BE 1 

NOS Version 1 Manual Abstracts 

84000420 

X 



NOS Version 1 Reference Manual, 





Volume 1 of 2 

60435400 

X 



NOS Version 2 Manual Abstracts 

60485500 


X 


NOS Version 2 Reference Set, 





Volume 3, System Commands 

60459680 


X 


NOS/BE Version 1 Manual Abstracts 

84000470 



X 

NOS/BE Version 1 Reference Manual 

60498300 



X 

Software Publications Release History 

60481000 

X 

X 

X 


CDC manuals can be ordered from Control Data Corporation, Literature and 
Distribution Services, 308 North Dale Street, St. Paul, Minnesota 55103. 


This guide describes a subset of the features and directives 
documented in the Query Update Version 3 Reference Manual. 
Control Data cannot be responsible for the proper functioning 
of features or directives not documented in the Query Update 
reference manual. 
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QUERY UPDATE AS A PROGRAMMING LANGUAGE 


1 


Query Update is a programming language that can be 
used to perform the following data processing 
operations: 

Store and remove data In existing files 

Modify data in records In existing files 

Sort and display data 

Perform arithmetic operations 

Generate special-purpose reports 

Prepare report formats and preserve them for 
later use 


Create data files 

Instructions are input to the Query Update program 
in statement form. Each statement, called a Query 
Update directive, specifies one task to be per¬ 
formed. Query Update can be called to perform a 
single task or a group of tasks that collectively 
represent one Query Update session. 


THE QUERY UPDATE USER 

Query Update meets the needs of a variety of users. 
For example: 

A nonprogrammer can access data files to dis¬ 
play selected fields of information, perform 
minor modifications, prepare simple reports, or 
request previously generated reports with only 
a few easy-to-leam instructions. 

A business programmer can search and manipulate 
data files through free-form directives rather 
than through complete program runs, and can 
construct and preserve various report layouts 
for subsequent reporting on data files. 

A scientific programmer can build individual 
data files either from scratch or from existing 
files, and perform any number of calculations. 


COMPARING QUERY UPDATE 
TO COBOL 

Query Update is a free-form data processing lan¬ 
guage. It contains no program divisions and imposes 
few restrictions on the order in which statements 
are submitted. 

The Query Update language is similar to COBOL, 
which is also a data processing language, in the 
following ways: 

Both group English terms into sentence-type 
instructions. 

Both use reserved words such as DISPLAY, SORT, 
EQ, and IF in each instruction. 

Both require descriptions of the file organiza¬ 
tion and storage of data and the characteristics 
of data. 

The terminology used in the descriptions is similar, 
but the methods for relaying the information to the 
program and operating system are different. 

When Query Update is accessing a permanent data 
base file, the file organization and data descrip¬ 
tion for the file must be predefined. Predefinition 
is performed by the data administrator; a program 
is written in DMS-170 Data Description Language 
(DDL), it is compiled into a DDL object directory, 
then it is stored into a permanent file via oper¬ 
ating system procedures. The DDL object directory 
is called a Query Update subschema. One or more 
compiled Query Update subschemas are stored on a 
permanent file called a subschema library. The 
COBOL counterparts of a subschema are the Environ¬ 
ment and Data Divisions. 

When Query Update is accessing a sequential file 
that is not part of a permanent data base (this 
type of file is called a non-data-base file), the 
subschema concept does not apply. The physical 
storage characteristics of a non-data-base file are 
declared in the FILE control statement. The data 
description is generated within the series of 
directives that make up a Query Update session. 
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QUERY UPDATE PROCESSING 


2 


Before you consider the actual structure of the 
Query Update language, you should become familiar 
with how data is classified and handled within the 
Query Update data and processing environments. 

THE DATA ENVIRONMENT 

Query Update handles three distinct categories of 
data: 

Data base file data items 
Non-data-base file data items 

Temporary data items for operations related to 
data base or non-data-base files 

A data base file is a file whose organization and 
content are described by a Query Update subschema. 
As mentioned in the previous section, the subschema 
must have been written in DDL source language by 
the data administrator, compiled into a DDL object 
directory, and stored onto a permanent file (called 
a subschema library) before the data base can be 
accessed. A data base file is accessed during a 
Query Update session through the CREATE or INVOKE 
directive. 

A non-data-base file is a sequential file whose 
organization and content is not described by a 
Query Update subschema. A typical non-data-base 
file might be a transaction file that has been read 
in from tape for one-time reporting or data base 
updating purposes. The directory of a non-data-base 
file must be generated through the DESCRIBE direc¬ 
tive before it can be accessed. A non-data-base 
file Is accessed during a Query Update session 
through the DISPLAY or EXTRACT directives. 

A temporary data item is an item that is defined 
with a DEFINE, DESCRIBE, or SPECIFY directive dur¬ 
ing a Query Update session. Once a temporary data 
item is defined, it can be used for comparing data 
items in a data base or non-data-base file or for 
modifying data items in a data base file. 

QUERY UPDATE LANGUAGE 
COMPONENTS 

Query Update language components include Query 
Update reserved words, recognized symbols, punc¬ 
tuation, and user-supplied elements (data-names. 


literals, expressions, conditions, and picture 
specifications). These components are grouped 
together into statements for input to the Query 
Update program. Each complete statement is called 
a directive. Each directive represents one task, to 
be performed by the computer. 


A reserved word is always the first word in a 
directive and identifies the task to be performed. 
The keyword can be followed by a number of user- 
supplied elements as well as additional Query Up¬ 
date keywords. For example, the following directive 
asks Query Update to make a subschema and its 
associated data base files available to the tasks 
that will follow it: 

INVOKE subschema-name 

FROM LIBRARY permanent-file-name 
(permanent-file-parameters [PW]) 

Operating system parameters are required 
when permanent files are referenced in a 
directive. 


The following directive describes the first data 
item in a non-data-base file directory: 

DESCRIBE non-data-base-file-name 
AND data-name 
AS CHARACTER BY $X(10)$ 

The $ delimiters are required when a non¬ 
numeric literal is specified. 


The following directive defines a temporary item 
for use in subsequent tasks: 

DEFINE data-name AS NUMERIC BY 999 

The $ delimiters are not required when a 
numeric literal is specified. 

A summary of Query Update directives is shown in 
table 2-1. The directives are listed in alphabetic 
order by reserved word, which identifies the purpose 
of the directive. The comments column provides 
some rules and default options for each directive. 
See the Query Update Version 3 Reference Manual for 
details about the directives. 
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TABLE 2-1. QUERY UPDATE DIRECTIVES 


Directive 

Description 

Comments 

ALTER 

Locates retained report directives 
from the catalog for subsequent 
modification. 

The designated report must have been created by a 
previous FORMAT directive and must reside on the 
current catalog. 

BREAK 

Indicates situations that cause 
interruption of the body of the 
report to insert footings and 
headings; interruption can occur 
when data name content changes or 
stated conditions are met. 

BREAK is associated with a HEADING and FOOTING 
directive. 

Level number 0 cannot be specified. 

COMPILE 

Stores report specifications in 
encoded form on a table file. 

After the table file has been generated by the COMPILE 
directive, it is available for input to the Report 
Utility. The REPORT control statement calls the 

Report Utility program to produce reports according to 
specifications in the table file. 

CREATE 

Establishes a data base file, 
known as an area, for subsequent 
insertion of data. 

When alternate keys are defined for the area, the 

INDEX option is required if the index file name is not 
specified in the subschema. 

The FROM LIBRARY option is required if the subschema 
library permanent file name is different from the sub¬ 
schema name. 

The area and applicable index file must be made perma¬ 
nent if the files are to be saved for future use. 

DATE 

Specifies use and positioning of 
system-supplied date information 
within a report. 

Default vertical positioning is line 1. Default hori¬ 
zontal positioning is column 2. 

DEFINE 

Establishes temporary data names 
and storage requirements. 

Floating point is the default internal format. 

When the ITEMS option is included, an array is gen¬ 
erated, and subscripting is subsequently required. 

When temporary data items are to be evaluated, the 
method of evaluation must be specified through the 

VALUE (or -) option. 

DESCRIBE 

Establishes a directory to the 
content of a non-data-base file. 

FILLER should be used for those portions of the record 
that are not to be referenced. 

DETAIL 

Determines report line content and 
positioning of source data fields, 
literals, and computed values. 

When tag numbers are included, SELECT directives are 
required. 

The AT LINE default is positioned one line beyond the 
preceding line. 

The ONCE option can be used only when no more than one 
numbered DETAIL line directive is specified in the 
report format. 

When no points are specified by an IN clause, the 
CENTERED default horizontal points are column 1 and 
the page width or column 1 and the section width if 
multiple sections are specified. 

DIAGNOSTIC 

Specifies whether or not consecu¬ 
tive duplicate diagnostic messages 
are to be displayed. 

The default is no display of consecutive duplicate 
diagnostic messages. 
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Directive 

DISPLAY 

DUPLICATE 

END 

ERASE 


EVALUATE 


EXECUTE 

EXHIBIT 

EXTRACT 


TABLE 2-1. QUERY UPDATE DIRECTIVES (Contd) 


Description Comments 


Displays information from a data The UPON default is the terminal or the output file, 

base file, non-data-base file, or 

temporary storage. The FROM option requires a directory for the desig¬ 

nated file; it must be produced by a DESCRIBE, DISPLAY 
UPON (directory not generated on NOS 1), or EXTRACT 
directive. Query Update rewinds the specified file 
before displaying FROM. 

Copies recorded information be- Must be preceded by the VERSION directive, which 

tween the user catalog and the attaches the user catalog, 

default catalog. 

Terminates Query Update operations Default catalog, created area, and report dispositions 
and returns control to the oper- are determined by the user and performed at this time 

ating system. through applicable operating system procedures. 

Removes DEFINE items or SPECIFY A single item in a matrix or a literal cannot be 

items. erased. 

Removes one or more report speci¬ 
fications or session-IDs from the 
current catalog. 

Eliminates a directory created by 
a DESCRIBE, DISPLAY UPON (direc¬ 
tory not generated on NOS 1), or 
EXTRACT directive. 

Performs arithmetic operations to The IF directive can be used in conjunction with 
compute data name content or a EVALUATE for manipulative operations, but not for 

cumulative function result. report operations. 

Selects the working storage data For report operations, the EVALUATE directive must be 

names for which values are to be preceded by an ALTER or FORMAT directive, 

calculated when a particular 

report production step occurs. If EVALUATE is initializing items to be included as 

part of a detail line, the directive should be related 
to the DETAIL directive and not to SELECT. 

Causes execution of a procedure The procedure name must be l through 7 characters in 

that is external to Query Update. length. The procedure must be in relocatable format. 

Lists information that is recorded Default report specifications, working storage data 

in the current catalog. names, report names with associated report specifica¬ 

tions, session IDs with associated directives, rela¬ 
tions with associated record names, Item names in 
record, and area names in use can be displayed. 

Creates a subset of information in Rewind operations before and after an EXTRACT direc- 
a data base file, non-data-base tive ensure correct programming, 

file, or temporary storage, and 

creates a directory to the subset. When data is renamed through the AS option, the data 

must be referenced by the new name while the EXTRACT 
is still in effect. 

Data items can be selected by using the EXTRACT direc¬ 
tive with an IF directive. Items in an array must be 
individually extracted. 
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TABLE 2-1. QUERY UPDATE DIRECTIVES (Contd) 


Directive 

Description 

Comments 

FOOTING 

Provides content and determines 
line and column positioning for 
informative footings. 

A FOOTING directive is associated with a BREAK 
directive. 

Level number 0 is associated with the end of data. 

The AT LINE default is positioned one line beyond the 
preceding line. 

When no points are specified by an IN clause, the 
CENTERED default horizontal points are column 1 and 
the page width. 

FORMAT 

Initiates grouping and retention 
of directives in the catalog under 
a report name for reference by 
other directives. 

The report name must be unique in the current catalog. 

HEADING 

Provides content and determines 
line and column positioning for 
informative headings. 

A HEADING directive is associated with a BREAK 
directive. 

Level number 0 occurs before any data is processed. 

The AT LINE default is positioned one line beyond the 
preceding line. 

When no points are specified by an IN clause, the 
CENTERED default horizontal points are column 1 and 
the page width. 

HELP 

Presents descriptions of direc¬ 
tives or explanations of diag¬ 
nostic messages. 

The HELP directive can be entered at any time during 
a Query Update session. 

IF 

Presents a test condition to 
determine whether subsequent 
directives are to be executed 
or bypassed. 

An IF directive that references only temporary data 
items and literals can be used with any directive. 

An IF directive controls execution of the directives 
that follow it in the same transmission, up to but not 
including the next IF directive. 

IF directives cannot be nested. 

INVOKE 

Establishes areas, relations, and 
the subschema that is used for 
subsequent directives. 

The FROM LIBRARY option identifies the subschema 
library that contains the subschema directory being 
used. 

MODIFY 

Modifies a data item value in an 
existing record in a data base. 

Only one area can be modified at a time; each area 
joined in a relation must be modified separately. 

A record is selected for modification either by refer¬ 
encing the record key in the USING option or as a 
result of an IF directive with an associated MODIFY 
directive. 

The SETTING option specifies the names of the data 
items to be modified. 

MOVE 

Places values in data names. 

Places values in data items when 
a particular report production 
step occurs. 

Defined data items that require evaluation must be 
evaluated before the MOVE directive is executed. 

When one record is being updated, MOVE is used in 
conjunction with the MODIFY directive. 

For report operations, the MOVE directive must be 
preceded by a FORMAT or ALTER directive. 
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TABLE 2-1. QUERY UPDATE DIRECTIVES (Contd) 


Directive 

Description 

Comments 

NOTE 

Allows user comments to be in¬ 
cluded in transmissions. 

User comments do not appear in output or as part of a 
report. 

OS 

Allows the user to enter an oper¬ 
ating system command during a 

Query Update session. 

An OS directive can be recorded as part of a session. 

The directive is not allowed in batch mode. 

PAGE-NUMBER 

Specifies use and positioning of 
system-supplied page number within 
a report. 

Positioning default is the rightmost 10 characters of 
the page, line 1. 

PAGE-SIZE 

Specifies maximum number of ver¬ 
tical lines, horizontal columns, 
horizontal or vertical sectional 
page divisions, and multiple copy 
images. 

Default page length is 60 lines; default page width is 
136 columns, 1 section, and 1 image. 

A maximum of 10 sections can be specified. If 
sections are specified, the default number of columns 
divided by the number of sections rounded down is the 
width of a section. 

The default PARALLEL option is alternating left and 
right sides of a composite page when a report page is 
larger than one printer page. 

PERFORM 

Retrieves and executes trans¬ 
missions recorded in the current 
catalog. 

When no options are included, the entire cataloged 
session is executed. 

PREFACE 

Causes lines of text or another 
report to precede the first page 
of a report. 

A specified report name must be in the current 
catalog. 

A preface for the specified report name is Included 
in the output report. 

PREPARE 

Initiates execution of report 
directives. 

The specified report name must be in the current 
catalog. 

The source data file is automatically rewound before 
report preparation. The report output file is not 
rewound before or after report preparation. 

PREVIEW 

Causes sample execution of report 
directives. 

The specified report name must be in the current 
catalog. 

The FROM default is dummy data values of X's and Y's 
for character information and 8's and 9's for numeric 
information. 

RECAP 

States content and positioning of 
recapitulative information gen¬ 
erated at the end of each report 
page. 

The AT LINE default is positioned one line beyond the 
last detail or footing line. 

When no points are specified by an IN clause, the 
CENTERED default horizontal points are column 1 and 
the page width. 

RECORDING 

Initiates the recording of subse¬ 
quent transmissions in the current 
catalog. 

Recording continues until RECORDING OFF is specified. 

Report specification directives for a report format 
are not recorded; they are retained in the current 
catalog under the report name established by the 

FORMAT directive. 

REMOVE 

Removes specific records from a 
data base file. 

Only records from one area can be removed at a time; 
records from each area joined in a relation must be 
removed separately. 

A complete record, not part of a record, is removed. 
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TABLE 2-1. QUERY UPDATE DIRECTIVES (Contd) 


Directive 


Description 


Releases a file, relation, or sub¬ 
schema that is no longer oeeded by 
Query Update. 


Logically positions a file at the 
beginning-of-inforeflation. 

Indicates alternative DETAIL 
specifications are to be selected 
when stated conditions are met. 


Multiple files can be returned with one RETURN 
directive. 

A file established with a CREATE directive requires 
two RETURN directives; the first to return the area 
information, the second to return the file. 

Multiple files can be rewound with one REWIND 
directive. 

When DETAIL directives include tag numbers, SELECT 
directives are required. The tag number must corre¬ 
spond to a DETAIL tag number. 

A maximum of five tag numbers can be specified; the 
number can be modified at installation time. 

If a MOVE or EVALUATE directive is used for initial¬ 
ization of items to be Included as part of a detail 
line, the directive should be related to the DETAIL 
directive and not the SELECT directive. 

When multiple selects exist, only the first qualifying 
select is executed. 


SEPARATOR I Defines a character to be used for 
delimiting nonnumeric literals. 


The dollar sign ($) is the default separator. 

A character defined as a universal character cannot be 
defined as a separator. 


Specifies and initiates the re¬ 
sequencing of source data. 


The ITEM-SIZE option is not used in report production. 

Before a file can be sorted, it must have a directory 
produced by a DESCRIBE, DISPLAY UPON (directory not 
generated on NOS 1), or EXTRACT directive. 


Establishes a name for convenient 
reference to a condition. 


The default collating sequence is COBOL. 

The default ordering sequence is ascending. 

A maximum of 25 sorting fields can be defined; each 
can be defined as either ascending or descending. 

Specified conditions can be tested by IF and SELECT 
directives. 


Creates a new record and places it 
in a data base file. 


Only one area can be modified at a time; each area 
joined in a relation must be modified separately. 

The SETTING option specifies the names of the data 
items to be stored. 


Causes lines of text or another 
report to follow the last page of 
a report. 


Relates tabular references to 
horizontal column numbers for 
report preparation. 

Specifies use and positioning of 
system-supplied time information 
within a report. 


A specified report name must be in the current 
catalog. 

A summary for the specified report name is included 
in the output report. 

Tab numbers need not be entered in sequence because 
the system sorts them in ascending order. 


Default vertical positioning is line 1; default hori¬ 
zontal positioning is column 90. If the page size is 
less than 99 columns, the default horizontal position¬ 
ing is the page width minus 29 columns. 
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TABLE 2-1. QUERY UPDATE DIRECTIVES (Contd) 


Directive 

Description 

Comments 

TITLE 

States content and positioning of 
title to start a report page. 

Default vertical positioning is line 1; default hori¬ 
zontal positioning is column 1. 



When no points are specified by an IN clause, the 
CENTERED default horizontal points are column 1 and 
the page width. 

UNIVERSAL 

Establishes a character that marks 
a character position to be ignored 
during comparison testing. 

The default universal character is # in the ASCII 
character set and = in the CDC graphic set. 

The current separator character cannot be defined as 
the universal character. 

VERIFY 

Specifies data names for terminal 
display in response to a previous 
VETO directive. 

The specified data items are displayed in response to 
a directive that causes a record to be modified or 
deleted. 



The directive is not allowed in batch mode. 

VERSION 

Attaches a permanent file as the 
current catalog or reverts to the 
default catalog. 

Permanent file parameters are required unless the sub¬ 
schema declares the area as TEMP. 

VETO 

Causes a terminal display of 
data subject to modification or 
deletion. 

The directive is not allowed in batch mode. 

VIA 

Specifies which relation should be 
followed. VIA is needed when more 
than one relation is defined and 
the relation to be used cannot be 
determined by Query Update. 

If more than one VIA directive is entered in a trans¬ 
mission, only the last one specified is used. A VIA 
directive remains in effect until another VIA direc¬ 
tive is entered. 


USING QUERY UPDATE 

Query Update functions in interactive mode through 
a user terminal. Query Update asks for input, the 
user enters directives, then Query Update responds. 
The results of the operation requested by the 
directives are displayed or printed on output 
devices. Output devices can include a terminal 
display screen, terminal hardcopy printer, line 
printer, or any combination of the three. 

One or more directives can be used to specify a 
complete operation. A complete operation is called 
a transmission. A transmission begins with a 
directive keyword and ends when a SEND, RETURN, or 
equivalent transmit key is depressed. Query Update 
executes or records the transmission and then 
returns one or more of the following: 

The information requested by the transmission 

An error message 

A double hyphen (—), which Indicates that 
Query Update is ready to receive the next 
transmission 

A double greater-than symbol (»), which indi¬ 
cates that Query Update is ready to receive data 

A physical transmission (a transmission as defined 
by the operating system) can contain a maximum of 


150 characters on NOS and can contain an unlimited 
number of characters on NOS/BE. A logical trans¬ 
mission (a transmission as defined by Query Update) 
can contain a maximum of 1030 characters. The 
maximum logical transmission length can be changed 
by setting the TL parameter on the Query Update 
control statement. 

When a logical transmission exceeds the line width 
of the terminal, the system performs an automatic 
carriage return and line-feed, then continues to 
accept input on the next line. 

Automatic continuation can be more convenient to 
use than manual continuation. Under automatic 
continuation, a user can backspace to the beginning 
of a physical transmission to correct a typing 
error. 

Transmissions can be manually continued by entering 
one of two continuation characters (+ or = ) as the 
last character on the line and depressing the 
transmit key. A manually continued transmission 
can include a maximum of 1030 characters or the 
number of characters specified by the TL param¬ 
eter. At least one space is required between 
the last nonblank character and the continuation 
character. 

Interactive mode is considered to be the most 
convenient method for using Query Update. Three 
exceptions might be the following: 
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Hardware communication is established by depressing 
the switches necessary to turn on the remote termi¬ 
nal equipment, dialing into the host computer, and 
completing the connection between the terminal and 
the computer. 

Software communication is established by a login 
procedure. The login procedure is a dialog that is 
required for user identification and accounting 
purposes. Login procedures for NOS and NOS/BE are 
shown in figure 2-1. User input is underscored. 

A Query Update session is begun when you enter a QU 
control statement. 


NOS 1 


82/04/26. 16.12.01. TM109 

NOS 1 SN614 

FAMILY: 

USER NAME: QUSER 
PASSWORD: QUPSWRD 
TM109 - APPLICATION: IAF 

TERMINAL: 30, NAMTCT 

RECOVER/ CHARGE: CHARGE,XXXX,XXXXXX 

READY. 

BATCH 

IrTlTO. 

/ QU 

QUERY UPDATE 3.3 538-81027 82/04/26 18.05.34 


NOS 2 


82/04/20. 09.52.56. T1211 
(22) SVL SN452 NOS CLSH. 

FAMILY: 

USER NAME: QUSER 
PASSWORD; QUPSWRD 
T1211 - APPLICATION: IAF 

JSN: AARY, NAMIAF 
/ QU 

QUffeY UPDATE 3.4 SYSEDIT-82088 


NOS/BE 1 


CONTROL DATA INTERCOM 5.1 
DATE 04/26/82 
TIME 10.27.50. 

PLEASE LOGIN 
LOGIN 

ENTER USER NAME- QUSER 
XXXXXXXXXX ENTER PASSWORD- 


04/26/82 LOGGED IN AT 10.27.50. 
WITH USER-ID KG 
EQUIP/PORT 63/077 


LOGIN CREATED 04/26/82 TODAY IS 04/26/82 

COMMAND- QU 

QUERY UPDATE 3.4 564-82062 04/26/82 10.28.29 


N2S-4RAM3/R2C. 


82/04/20 09.53.28 


When a large data base is being created. 

When a long report format is being entered and 
terminal hardcopy output is not available. 

When a long sequence of transmissions must be 
entered in the session. 


Beginning a Query Update Session 

Before beginning a Query Update session you must 
establish communication between the terminal and 
the host computer. 


Figure 2-1. Login Procedures 
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Ending a Query Update Session 

A Query Update session is ended when you enter an 
END directive. 

Software communication is terminated by a logout 
procedure. The logout procedure is a single user 
command. Logout procedures for NOS and NOS/BE are 
shown in figure 2-2. User input is underscored. 


NOS 


? END 
/ BYE 


NOS/BE 


END 

COMMAND- LOGOUT 


Figure 2-2. Logout Procedures 

Hardware communications are terminated by depressing 
the switches necessary to turn off the remote 
terminal equipment and releasing the telephone 
connection between the terminal and the computer. 

THE PROCESSING ENVIRONMENT 

The Query Update processing environment using CYBER 
Record Manager (CRM) varies depending on the type 


of file (data base or non-data-base) being accessed. 
The basic requirement for either type of file 
access is the existence of a directory that de¬ 
scribes the physical storage and characteristics of 
individual data items. Query Update processing is 
shown in figure 2-3. 


The left portion shows user input to the Query 
Update program via a user terminal. Input consists 
of Query Update directives and data entered as a 
series of transmissions. 


The center portion shows the Query Update program 
and how it interfaces with the Report Utility and 
CRM. 


The Report Utility program is callable through the 
REPORT control statement of the operating system. 
This utility automates report writing. The report 
information table file contains encoded report 
specifications that are generated by the COMPILE 
directive of the Query Update language and used by 
the Report utility. The catalog of directives is a 
series of recorded report specifications that have 
been generated and stored in mass storage for 
subsequent use. 


CRM performs input/output processing for data base 
files according to the information passed through 
the subschema. CRM performs input/output process¬ 
ing for non-data-base files according to information 
provided by the user. 

The right portion shows output to the user from the 
Query Update program to a line printer or terminal 
display screen. 
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INPUT FROM USER 


MASS STORAGE AND CPU 
PROCESSING ELEMENTS 


mm sub- m# 

»S$Sy sc heaa -i;:!:-:! 


OUTPUT TO USER 



Printer 



Shaded portions apply to a data base file described by a previously compiled subschema directory. 


Nonshaded portions apply to operations on both data base and non-data-base files. 


Figure 2-3. Query Update Processing 
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DATA BASE FILE OPERATIONS 
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Every data base file accessed through the Query 
Update language must be described in a directory 
called a Query Update subschema. The subschema 
declares the organization of the file, indicates 
the physical storage of the data, defines data 
names, and describes the characteristics of each 
data item. 

There are two types of Query Update subschemas: one 
in which a data base is defined by a subschema and 
controlled by CYBER Database Control System (CDCS), 
and one in which a data base is defined by a sub¬ 
schema and controlled by CYBER Record Manager (CRM). 
This guide only deals with Query Update in CRM data 
base access mode. 

You can access an existing data base file after you 
generate and store a Query Update subschema that 
corresponds to the file. You can, alternatively, 
generate and store a Query Update subschema first, 
and then create a file to match the description set 
up in the subschema. This latter approach is taken 
in the following paragraphs. 


GENERATING A QUERY UPDATE 
SUBSCHEMA 

The generation of Query Update subschemas is nor¬ 
mally performed under the direction of a data 
administrator. This conforms to the DMS-170 data 
base management concept that data base information 


should be centrally controlled. Detailed informa¬ 
tion regarding Query Update subschema generation is 
contained in the Query Update/CYBER Record Manager 
Data Administration reference manual. 

The NOS job structure and DDL source statements 
required to generate a Query Update subschema are 
shown in figure 3-1. 

The subschema contains the following divisions: 

The Identification Division, which names the 
subschema. 

The Data Division, which names the file, sup¬ 
plies file organization and key specification 
for CRM and describes the record. 

The subschema is named QUSUB. 

The data base file is named INVENTORY. Notice that 
the subschema refers to the file as an area. Sev¬ 
eral areas could have been included in this sub¬ 
schema, but only one was selected. 

File organization is new indexed sequential (which 
means extended indexed sequential). The primary 
key is INV-NO, the alternate key is BACK-ORDER. 

The index file is named INVIDX. The INDEX state¬ 
ment is optional; when it is not included in the 
subschema, the index for files with alternate keys 
must be declared at Query Update execution time. 


Job statement 
USER control statement 
CHARGE control statement 
DEFINE(QUSUB/CT=PU,M=R) 

DDL3(QD,SB=QUSUB) 

End-of-record 

IDENTIFICATION DIVISION. 

SUB-SCHEMA NAME IS QUSUB 
DATA DIVISION. 

AREA-NAME IS INVENTORY UN IS username M IS W 
INDEX IS INVIDX UN IS username M IS W 
ORGANIZATION IS INDEXED NEW 
KEY IS INV-NO 

KEY IS ALTERNATE BACK-ORDER DUPLICATES INDEXED 
RECORD-NAME IS INV-REC 

02 INV-NO PICTURE X(6) 

02 IN-STOCK PICTURE Z(3)9 
02 BACK-ORDER PICTURE Z(3>9 
02 ON-ORDER PICTURE Z(3>9 
02 RE0RDER-PT PICTURE Z(3)9 
02 UNIT-COST PICTURE Z(4).99 
02 UNIT-PRICE PICTURE Z(4>.99 
02 DESCRIPTION PICTURE X(17) 

End-of-informat ion 


Figure 3-1. Generating a Subschema Under NOS 
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The record is named INV-REC and has elghC fields, 
which are alphanumeric, as indicated by the X 
descriptor. The remaining fields are numeric. 
Because reports are to be generated from the 
INVENTORY file, editing characters are included in 
appropriate picture specifications. 

The DEFINE control statement effects permanent file 
storage. The file is declared public by the CT 
parameter and the file access mode is declared 
read-only by the H parameter. (The file access 
mode only affects users who have a different user 
number.) 

The DDL control statement specifies two required 
parameters: QD specifies that a Query Update sub¬ 
schema is to be compiled and SB«*QUSUB denotes the 
file name upon which the subschema is to be written. 

The NOS/BE job structure and DDL statements required 
to generate a subschema are shown in figure 3-2. 

The REQUEST and CATALOG control statements are 
required for permanent file storage of the sub¬ 
schema. The local file name is X and the permanent 
file name is QUSUB. 

The DDL control statement specifies two required 
parameters: QD denotes that a Query Update sub¬ 
schema is to be compiled and SB=X denotes the local 
file name upon which the subschema is to be written. 

CREATING A DATA BASE FILE 

Now that a subschema exists, a data base file named 
INVENTORY can be created through the CREATE direc¬ 
tive. The use of this directive is shown on NOS in 
figure 3-3. 


The DEFINE control statement effects permanent file 
storage of the INVENTORY file and its associated 
index file; the M parameter provides user write 
permission mode. The QU control statement calls 
the Query Update program. 

The hyphens (—) indicate that Query Update is 
expecting a directive. 

The CREATE directive performs the following func¬ 
tions: 


Names the data base file (INVENTORY) 

Names the index file (INVIDX) (required when 
alternate keys are specified in the subschema 
and when the index file is not specified in the 
subschema) 


Names the file name where the subschema is 
located 


The STORE directive is required when data is to be 
stored in the file. If this directive had not 
been included, the INVENTORY file would have been 
created, but would be empty; data could be entered 
at a later time. The SETTING option allows mul¬ 
tiple data items in a series of records to be 
inserted. Notice the continuation symbol (+). The 
space that appears between ON-ORDER and the + is 
required. The two greater-than symbols (>>) indi¬ 
cate that the program is expecting data. 


Job statement 

ACCOUNT control statement 

REQUEST(X,*PF) 

DDL3(QD,SB-X) 

CATALOG(X,QUSUB,ID=QUSER) 

End-of-record 

IDENTIFICATION DIVISION. 

SUB-SCHEMA NAME IS QUSUB 
DATA DIVISION. 

AREA-NAME IS INVENTORY ID IS QUSER 
INDEX IS INVIDX ID IS QUSER 
ORGANIZATION IS INDEXED NEW 
KEY IS INV-NO 

KEY IS ALTERNATE BACK-ORDER DUPLICATES INDEXED 
RECORD-NAME IS INV-REC 

02 INV-NO PICTURE X(6) 

02 IN-STOCK PICTURE ZC3J9 
02 BACK-ORDER PICTURE Z(3)9 
02 ON-ORDER PICTURE ZC3)9 
02 REORDER-PT PICTURE Z(3)9 
02 UNIT-COST PICTURE Z(4).99 
02 UNIT-PRICE PICTURE Z(4).99 
02 DESCRIPTION PICTURE X(17) 

End-of-information 


Figure 3-2. Generating a Subschema Under NOS/BE 
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/ DEFINE(INVENTO,INVIDX/CT=PU,M=W) 

/ QU 

QUERY UPDATE 3.4 SYSEDIT-82110 82/04/27 12.23.30 


? CREATE INVENTORY INDEX IS INVIDX OF QUSUB (UN=username) 


? STORE SETTING INV-NO IN-STOCK BACK-ORDER ON-ORDER + 
? REORDER-PT UNIT-COST UNIT-PRICE DESCRIPTION 
» SAB5972S 5395 175.79 389.95 SHETAL DESKS 
» SAB5973S 2001 500.00 1282.50 SOAK DESKS 
» SAB5975S 2131 900.00 1300.00 SUALNUT DESKS 
» SBB0013S 10 0 8 5 5.00 15.00 S6ULLETIN BOARDS 
» SCB0168S 8005 8.00 19.52 SCHALK BOARDS 
» SCB1001S 10 0 0 5 15.00 45.00 SI-DR FILE CABINETS 

» SCB1003S 10 0 0 5 20.00 60.00 $3-DR FILE CABINETS 

» SCB1005S 10 0 0 5 32.00 90.00 S5-DR FILE CABINETS 

» SCH0059S 7163 130.00 295.00 SARN CHAIRS 

» SCH0060S 5003 89.00 149.95 SDESK CHAIRS 
» SCH0080S 9003 35.00 96.00 SSWIVEL CHAIRS 
» SCH0575S 50 0 6 10 .98 3.98 SLETTER RACKS 
» SSH0011S 10 0 3 5 20.00 39.95 S3-SHELF BOOK CASES 
» SST0592S 7 0 0 3 9.50 16.20 SSTOOLS 
» STY5015S 2001 329.00 369.00 SELECT TYPEHRITERS 
» SXM6158S 10 0 0 2 38.00 95.00 SCOFFEE TABLES 
» SYB0020S 500 0 0 20 5.50 19.95 SDESK LAMPS 
» SYB0059S 25 0 0 20 18.50 69.95 SFLOOR LAMPS 
» SYB0060S 20 0 4 5 13.30 39.95 STABLE LAMPS 
» *END 

19 ACCESSES, 19 HITS, 19 IO-S 


? END 


Figure 3-3. Creating a Data Base File Under NOS 


Each data entry includes an item for each field 
specified in the STORE directive. Data is entered 
in the order indicated by the data names in the 
SETTING option; INV-NO data is first, IN-STOCK data 
is second, and so forth. Data fields are separated 
from each other by at least one space (a comma 
could be used Instead of a space). Several addi¬ 
tional points concerning the data entries should be 
noted: 

The INV-NO and DESCRIPTION fields are described 
as alphanumeric in the subschema; therefore, 
they must be enclosed in $ delimiters. These 
fields are stored with the appropriate number 
of trailing blanks. 


number of leading zeros. The Z replacement 
character in the subschema causes suppression 
of leading zeros when the fields are output in 
display mode. 

The data entries are followed by an *END directive, 
which terminates the STORE directive. 


The last entry is the END directive, which termi¬ 
nates the Query Update session. 

The INVENTORY data base file can be created under 
NOS/BE with the job stream shown in figure 3-4. 


Two CATALOG control statements effect permanent 
The numeric fields do not require $ delimiters. file storage of the INVENTORY file and its asso- 

These fields are stored with the appropriate ciated index file. 
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COMMAND- QU 

QUERY UPDATE 3.3 528-81027 05/16/81 14.31.14 


CREATE INVENTORY INDEX IS INVIDX OF QUSUB (ID=userna»e) 

STORE SETTING INV-NO IN-STOCK BACK-ORDER ON-ORDER + 
REORDER-PT UNIT-COST UNIT-PRICE DESCRIPTION 

» 

SAB5972S 5395 175.79 389.95 SMETAL DESKS 

» 


» 

*END 

19 ACCESSES, 19 HITS, 19 IO-S 
END 

COMMAND- CATALOG(INVENTO,INVENTORY,ID=QUSER> 
COMMAND- CATALOG(INVIDX,ID=QUSER) 


Figure 3-4. Creating a Data Base File Under NOS/BE 


QUERYING A DATA BASE FILE 

Interactive query always begins with a call to the 
Query Update program. This is done by typing the 
letters QU in response to the operating system 
request for input. NOS requests input by printing 
a slash (/). NOS/BE requests input by printing the 
word COMMAND-. 

When the Query Update program is loaded into memory, 
a Query Update heading is printed followed by a 
request for input. Query Update requests input by 
printing double hyphens (—) followed by a line¬ 
feed. On NOS, Query Update also prints a question 
mark (?). 

A data base file must be attached before it can be 
accessed for interactive query. This is done 
through the INVOKE directive, which names the 
subschema and the subschema library (if the sub¬ 
schema library name is different from the subschema 
name) and provides user identification. Query 
Update automatically attaches the data base file, 
together with its associated index file, when it is 
needed and returns the files when they are not 
needed. 

Sample directives for interactive query are shown 
in figure 3-5. The following points should be 
noted: 

The INVOKE directive references permanent files. 

Certain parameters are required as shown in the 

figure. 


Query Update displays only 14 lines at one 
time. After each group of lines, the program 
pauses and offers the option to continue the 
display or terminate the directive. 


The IF directive can be used in conjunction 
with the DISPLAY directive to provide condi¬ 
tional query. 


MODIFYING A DATA BASE FILE 

Modifications to a data base file are made by three 
Query Update directives: MODIFY, STORE, and REMOVE. 
Specific operations and general directive formats 
are listed as follows: 

Modify like fields in several records. 

MODIFY USING key-name 

MOVE expression TO data-name-1 
» key-name-value 

Store values in one or more fields for one new 
record. 

STORE MOVE expression-1 TO data-name-1 
AND expression—2 TO data-name-2 

Store values for like fields in several new 
records. 

STORE SETTING 

data-name-1 data-name-2 data-name-3 
» data-name-l-value data-name-2-value 
da ta-name-3—value 


Remove one or more records. 

REMOVE USING key-name 
» key-name-value 
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/ QU 

QUERY UPDATE 3.4 SYSEDIT-82110 82/04/29 13.05.46 

? INVOKE QUSUB (UN=username) 


? DISPLAY INV-NO DESCRIPTION IN-STOCK + 
? REORDER-PT UNIT-COST UNIT-PRICE 


AB5972 

METAL DESKS 

5 

5 

175.79 

389.95 

AB5973 

OAK DESKS 

2 

1 

500.00 

1282.50 

AB5975 

WALNUT DESK 

2 

1 

900.00 

1300.00 

BB0013 

BULLETIN BOARD 

10 

5 

5.00 

15.00 

CB0168 

CHALK BOARD 

8 

5 

8.00 

19.52 

CB1001 

1-DR FILE CABINET 

10 

5 

15.00 

45.00 

CB1003 

3-DR FILE CABINET 

10 

5 

20.00 

60.00 

CB1005 

5-DR FILE CABINET 

10 

5 

32.00 

90.00 

CH0059 

ARM CHAIR 

7 

3 

130.00 

295.00 

CH0060 

DESK CHAIR 

5 

3 

89.00 

149.95 

CH0080 

SWIVEL CHAIR 

9 

3 

35.00 

96.00 

CH0575 

LETTER RACK 

50 

10 

.98 

3.98 

SH0011 

3-SHELF BOOK CASE 

10 

5 

20.00 

39.95 

ST0592 

STOOL 

7 

3 

9.50 

16.20 

(MORE.. 

.. ANSWER Y OR N) 





, T 

TY5015 

ELECT TYPEWRITER 

2 

1 

329.00 

369.00 

XN6158 

COFFEE TABLE 

10 

2 

38.00 

95.00 

YB0020 

DESK LAMP 

500 

20 

5.50 

19.95 

YB0059 

FLOOR LAMP 

25 

20 

18.50 

69.95 

YB0060 

TABLE LAMP 

20 

5 

13.30 

39.95 


19 ACCESSES, 19 HITS, 19 IO-S 


? IF INV-NO EQ SY0OO6OS DISPLAY INV-REC 

(209) REQUESTED DATA MAY NOT BE IN DISPLAY FORMAT 
YB00600020000000040005001330003995TABLE LAMP 


1 ACCESSES, 

1 HITS, 1 IO-S 

' IF UNIT-PRICE LE 

40 DISPLAY DESCRIPTION 

' UNIT-PRICE 


BULLETIN BOARD 

15.00 

CHALK BOARD 

19.52 

LETTER RACK 

3.98 

3-SHELF BOOK CASE 

39.95 

STOOL 

16.20 

DESK LAMP 

19.95 

TABLE LAMP 

39.95 

19 ACCESSES, 

7 HITS, 19 IO-S 


? IF IN-STOCK GE 5 DISPLAY DESCRIPTION + 


? IN-STOCK 

METAL DESKS 5 
BULLETIN BOARD 10 
CHALK BOARD 8 
1-DR FILE CABINET 10 
3-DR FILE CABINET 10 
5-DR FILE CABINET 10 
ARM CHAIR 7 
DESK CHAIR 5 
SWIVEL CHAIR 9 
LETTER RACK 50 
3-SHELF BOOK CASE 10 
STOOL 7 
COFFEE TABLE 10 
DESK LAMP 500 


(MORE... ANSWER Y OR N) 

? N 

18 ACCESSES, 14 HITS, 18 IO-S 


Figure 3-5. Querying a Data Base File (Sheet 


Call Query Update. 


Name the subschema. NOS/BE 
requires an ID parameter 
instead of a UN parameter. 

Display six fields. 


A Y response continues the 
display. 


Request a conditional 
display by primary key. 

The primary key is alphanu¬ 
meric and requires the $'s. 
Full record display is never 
in display format. 

Request a conditional display 
using the relational operator 
less than or equal to. 


Request a conditional display 
using the relational operator 
greater than or equal to. 


An N response terminates the 
display. 
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? DISPLAY DESCRIPTION $$$$ UNIT-PRICE 


METAL DESKS 

$ 

389. 

.95 

OAK DESKS 

$ 

1282. 

.50 

WALNUT DESK 

S 

1300. 

.00 

BULLETIN BOARD 

$ 

15. 

.00 

CHALK BOARD 

S 

19, 

.52 

1-DR FILE CABINET 

$ 

45. 

.00 

3-DR FILE CABINET 

s 

60. 

.00 

5-DR FILE CABINET 

$ 

90, 

.00 

AIM CHAIR 

$ 

295, 

.00 

DESK CHAIR 

s 

149, 

.95 

SWIVEL CHAIR 

$ 

96. 

.00 

LETTER RACK 

s 

3, 

.98 

3-SHELF BOOK CASE 

s 

39. 

.95 

STOOL 

$ 

16. 

.20 

(MORE... ANSWER Y 

I V 

OR 

N) 


1 

ELECT TYPEWRITER 

s 

369, 

.00 

COFFEE TABLE 

$ 

95. 

.00 

DESK LAMP 

s 

19. 

.95 

FLOOR LAMP 

$ 

69. 

,95 

TABLE LAMP 

$ 

39. 

.95 


19 ACCESSES, 19 HITS, 19 IO-S 


? IF REORDER-PT = 3 AND UNIT-COST NE 130 + 
? DISPLAY DESCRIPTION REORDER-PT UNIT-COST 
DESK CHAIR 3 89.00 

SWIVEL CHAIR 3 35.00 

STOOL 3 9.50 

19 ACCESSES, 3 HITS, 19 IO-S 


? IF REORDER-PT = 3 OR UNIT-COST = 89 + 

? DISPLAY DESCRIPTION REORDER-PT UNIT-COST 
ARM CHAIR 3 130.00 

DESK CHAIR 3 89.00 

SWIVEL CHAIR 3 35.00 

STOOL 3 9.50 

19 ACCESSES, 4 HITS, 19 IO-S 


? DISPLAY (UNIT-PRICE - UNIT-COST) + 
? / UNIT-COST * 100 
000000000121.83 
000000000156.50 
000000000044.44 
000000000200.00 
000000000144.00 
000000000200.00 
000000000200.00 
000000000181.25 
000000000126.92 
000000000068.48 
000000000174.29 
000000000306.12 
000000000099.75 
000000000070.53 
(MORE... ANSWER Y OR N) 

? N 

15 ACCESSES, 14 HITS, 15 IO-S 


? END 


Figure 3-5. Querying a Data 


Display the $ literal. The 
$ is the separator character 
and must be specified twice 
for each occurrence. 


Request a conditional dis¬ 
play using the logical 
operator AND. 


Request a conditional dis¬ 
play using the logical 
operator OR. 


Request the display of an 
arithmetic expression. 
Default display is floating¬ 
point format. 


Terminate Query Update. 
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Sample directives for data base file modification 
are shown In figure 3-6. The following points 
should be noted: 

The REMOVE directive deletes an entire record, 
not part of a record. 

The IF directive can be used in conjunction 
with the MODIFY and REMOVE directives to pro¬ 
vide conditional modification. 


The ACCESS message indicates the total number 
of records accessed for modification; the HITS 
message indicates the total number of success¬ 
ful operations; the IO-S message indicates 
the total number of input/output operations 
required. 


Call Query Update. 


QUERY UPDATE 3.4 SYSEDIT-82110 


82/04/29 13.05.46 


? INVOKE QUSUB <UN=username) 


? MODIFY USIN6 INV-NO SETTIN6 ON-ORDER 


Name the subschema. NOS/BE requires an 
ID parameter Instead of a UN parameter. 

Modify one field in three records. 


» $485972$ 12 


» $AB5973$ 7 


» $AB5975$ 12 


» *END 

3 ACCESSES, 3 HITS/ 6 IO-S 


Terminate the MODIFY USING directive. 


? IF INV-NO EQ $SH0011 $ MODIFY MOVE 15 TO IN-STOCK 
1 ACCESSES, 1 HITS, 3 IO-S 


Request a conditional modification. 


? STORE SETTING INV-NO IN-STOCK BACK-ORDER ON-ORDER REORDER-PT + 
? UNIT-COST UNIT-PRICE DESCRIPTION 


Store three records. 


» SCH0100$ 5022 52.00 80.00 $TYPING CHAIRS 
» $CB1002$ 10 0 0 5 22.00 40.00 $2-DR FILE CABIN£T$ 
» $CB1004$ 10 0 0 5 37.00 75.00 $4-DR FILE CABINET$ 


» *END 

3 ACCESSES/ 3 HITS/ 3 IO-S 


Terminate the STORE SETTING directive. 


? REMOVE USING INV-NO 


Remove three records. 


» SYB0059S 


» SCB1005S 


» $C81001$ 


» *END 

3 ACCESSES, 3 HITS, 6 IO-S 


Terminate the REMOVE USING directive. 


? IF INV-NO EQ $XN6158$ REMOVE VETO 
XN61580010000000000002003800009500COFFEE 
VETO- NO 

1 ACCESSES, 1 HITS, 2 IO-S 


The VETO directive displays the first 
40 characters. 

A NO response cancels the remove re¬ 
quest. 
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? VERIFY DESCRIPTION 


? REMOVE USING INV-NO VETO 

» SST0592S 

STOOL 
VETO- YES 

» *END 

1 ACCESSES, 1 HITS, 2 IO-S 


? IF INV-NO EQ SXN6158$ REMOVE VETO 

COFFEE TABLE 
VETO- NO 

1 ACCESSES, 1 HITS, 2 IO-S 


? DISPLAY INV-NO DESCRIPTION 
AB5972 METAL DESK 
AB5973 OAK DESK 
AB5975 WALNUT DESK 
BB0013 BULLETIN BOARD 
CB0168 CHALK BOARD 
CB1002 2-DR FILE CABINET 
CB1003 3-DR FILE CABINET 
CB10D4 4-DR FILE CABINET 
CH0059 ARM CHAIR 
CH0060 DESK CHAIR 
CH0080 SWIVEL CHAIR 
CHOI00 TYPING CHAIR 
CH0575 LETTER RACK 
SH0011 3-SHELF BOOK CASE 
(MORE... ANSWER Y OR N) 

? Y 

TY5015 ELECT TYPEWRITER 
XN6158 COFFEE TABLE 
YB0020 DESK LAMP 
YB0060 TABLE LAMP 

18 ACCESSES, 18 HITS, 18 IO-S 


? END 


Figure 3-6. Modifying a 


The VERIFY directive requests display 
of the description field, rather than 
the first 40 characters. 


A YES response effects the remove 
operation. 


Request a conditional remove with the 
VERIFY option in effect. 


A DISPLAY operation shows that three 
records have been stored (CB1002, 
CB1004, and CH0100) and four records 
have been removed (CB1001, CB1005, 
ST0592, and YB0059). 


Terminate Query Update. 
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NON-DATA-BASE FILE OPERATIONS 


4 


A non-data-base file, as defined within the context 
of this guide, is a sequential file that has no 
corresponding Query Update subschema. When a non¬ 
data-base file is to be accessed by Query Update, 
the following requirements must be met: 

The file must be a local file. If the file 
Is a permanent file, it must be attached via 
the operating system permanent file attach 
procedure. 

The storage characteristics of the file must be 
conveyed to CYBER Record Manager (CRM) with a 
FILE control statement. 

The file must be described for Query Update 
with the DESCRIBE directive. 


For purposes of illustration, a non-data-base file 
has been stored on disk. The layout of the file is 
shown in figure 4-1. The file has the following 
characteristics: 

The file name is INDFILE. 

The file contains six records. 

Each record contains two fields. 

Field 1 contains six alphanumeric characters 

and field 2 contains four numeric characters. 

This file is a transaction file related to the data 
base file INVENTORY. INDFILE Includes values that 
correspond to values within the primary key field 
of INVENTORY. 


DESCRIBING A 
NON-DATA-BASE FILE 

Query Update accesses a non-data-base file accord¬ 
ing to the rules specified in a directory. Unlike 



field 1 field 2 

word 0 

A B 5 9 7 2 ' 0 0 2 5 


word 1 

1 

C BO 1 6 8 0050 


word 2 

1 

YB0020 0035 

| 


word 3 

BB001 3 0040 

i 


word 4 

A B 5 9 7 5 0022 

j 


word 5 

CH0060' 0033 
_i_ 



figure 4-1. INDFILE Format 


a data base file subschema directory that is gen¬ 
erated by DDL, a non-data-base file directory is 
generated by the Query Update DESCRIBE directive. 

The operating system control statements and Query 
Update directive required to establish access to 
the non-data-base file INDFILE are shown in figure 
4-2. The ATTACH and FILE control statements are 
required; they can precede the QU control statement 
and be entered in the usual manner or they can be 
entered through the Query Update OS directive. 
Only the BT and RT parameters are included on the 
FILE control statement; default values for other 
required parameters apply. 

The DESCRIBE directive includes the file name 
and assigns names for the two fields (IND-INV-NO 
and IND-ON-ORDER). The fields correspond to the 
INVENTORY file fields INV-NO and ON-ORDER. Data 
item IND-INV-NO is described as a six-character 
alphanumeric field and IND-ON-ORDER is described as 
a four-character zero-suppressed numeric field. 
The $ delimiters are required because of the non¬ 
numeric characters X 2 ) (. 


/ QU 

QUERY UPDATE 3.4 SYSEDIT-82110 

82/05/03 09.26.41 

Cal 1 Query Update. 


? OS,ATTACH,INDFILE 


Issue an operating 
mand for INDFILE. 

system ATTACH com- 

? OS,FILE,INDFILE BT=C,RT=F 


Issue an operating 
to declare INDFILE 

system FILE command 
file organization. 

? DESCRIBE INDFILE AND IND-INV-NO AS 
? AND IND-ON-ORDER AS NUM BY $Z(3)9S 

CHAR BY $X(6)S + 

Establish the directory for INDFILE. 


Figure 4-2. Describing a Non-Data-Base File 
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QUERYING A 
NON-DATA-BASE FILE 

You can query a non-data-base file after it has 
been attached, defined for CRM, and described for 
Query Update. Sample display operations are shown 
in figure 4-3. 

The following points should be noted for non-data¬ 
base file query operations: 

When the OS directives reference permanent 
files, certain parameters are required, as 
shown in the figure. 

The word FROM and the file name must be in¬ 
cluded in the DISPLAY directive. 

The file is always automatically rewound before 
a DISPLAY FROM directive is executed. 

Conditional testing with the IF directive is 
not allowed. 


ENTERING DATA IN A 
NON-DATA-BASE FILE 

Data can be placed in a non-data-base file by using 
the DISPLAY UPON format of the DISPLAY directive. 


Data is entered and displayed upon a non-data-base 
file rather than upon the terminal display screen. 
Data entered with the DISPLAY UPON directive under 
NOS is retained in a direct access file automati¬ 
cally, whereas data entered under NOS/BE with the 
directive must be retained with permanent file 
operations. 

Sample DISPLAY UPON operations are shown in figure 
4-4 for NOS and in figure 4-5 for NOS/BE. The 
following points should be noted for the DISPLAY 
UPON directive: 

The non-data-base file must be positioned at 
the end of information before the DISPLAY UPON 
directive is issued. Figure 4-4 shows the 
DISPLAY FROM directive positioning the file; 
figure 4-5 shows the OS directive positioning 
the file. The DISPLAY FROM directive for posi¬ 
tioning purposes is practical only when the 
file is small. 

The DISPLAY UPON directive eliminates any 
previously established directory and creates a 
directory for the file being displayed (direc¬ 
tory not created on NOS 1). 

The SEPARATOR (SEP ITEM-SIZE) directive tells 
Query Update to concatenate the fields in 
INDFILE. If SEP ITEM-SIZE had not been speci¬ 
fied, Query Update would have written one blank 
character before each item. 







? DISPLAY FROM INDFILE IND-INV-NO IND-ON-ORDER 


Display the INDFILE 

fields. 

AB5972 25 

CB0168 50 

YB0020 35 

B80013 40 

AB5975 22 

CH0060 33 






6 ACCESSES, 6 

HITS, 6 I0-S 




? DISPLAY FROM INDFILE (INVENTORY NUMBER IS$ + 

? IND-INV-NO SAND ORDER AMOUNT ISS IND-ON-ORDER 


Include nonnumeric 

literals in a display. 

INVENTORY NUMBER IS 

AB5972 AND ORDER AMOUNT IS 

25 



INVENTORY NUMBER IS 

CB0168 AND ORDER AMOUNT IS 

50 



INVENTORY NUMBER IS 

YB0020 AND ORDER AMOUNT IS 

35 



INVENTORY NUMBER IS 

BB0013 AND ORDER AMOUNT IS 

40 



INVENTORY NUMBER IS 

AB5975 AND ORDER AMOUNT IS 

22 



INVENTORY NUMBER IS 

CH0060 AND ORDER AMOUNT IS 

33 



6 ACCESSES, 6 

HITS, 6 I0-S 




? END 






Figure 4-3. Querying a Non-Data-Base File 
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/ QU 


Call Query Update 


QUERY UPDATE 3.4 SYSEDIT-82110 


82/05/03 10.09.16 


? OS,ATTACH,INDFILE/M=W 


Issue operating system ATTACH and FILE 
control statements. 


? OS,FILE,INDFILE,BT=C,RT=F 


? DESCRIBE INDFILE AND IND-INV-NO AS CHAR BY $X(6)$ + 
? AND IND-ON-ORDER AS NUM BY $Z(3)9$ 


Establish the directory for INDFILE. 


? DISPLAY FROM INDFILE IND-INV-NO IND-ON-ORDER 

AB5972 25 

CB0168 50 

Y80020 35 

BB0013 40 

AB5975 22 

CH0060 33 

6 ACCESSES, 6 HITS, 6 IO-S 


Position INDFILE at the end-of- 
information. 


? SEP ITEM-SIZE 


? DISPLAY UPON INDFILE SCH0575S $0006$ 


? DISPLAY UPON INDFILE $SH0011$ $0004$ 


? DISPLAY UPON INDFILE $TY5015$ $0012$ 


? DISPLAY UPON INDFILE $XN6158$ $0003$ 


Indicate to Query Update to concate¬ 
nate the fields. 

Enter four records in INDFILE. Under 
NOS 1, the DISPLAY UPON directive 
eliminates the old directory. Under 
NOS 2 and NOS/BE, the directive 
creates a new directory to INDFILE. 


? DESCRIBE INDFILE AND IND-INV-NO AS CHAR BY $X(6)$ + 
? AND IND-ON-ORDER AS NUM BY $Z(3)9$ 


Establish the directory for INDFILE 
under NOS 1. 


? DISPLAY FROM INDFILE IND-INV-NO IND-ON-ORDER 
AB5972 25 

C80168 50 

YB0020 35 

BB0013 40 

AB5975 22 

CH0060 33 

CH0575 6 

SH0011 4 

TY 5015 12 

XN6158 3 

10 ACCESSES, 10 HITS, 10 IO-S 


The DISPLAY operation verifies that 
four records have been added to the 
fi le. 


The added data is made permanent. 


Figure 4-4. Entering Data Into a Non-Data-Base File Under NOS 
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COMMAND- QU Call Query Update. 

QUERY UPDATE 3.3 538-81089 82/05/03 10.09.16 


OS,ATTACH,INDFILE,ID=QUSER Issue operating system ATTACH and FILE con¬ 

trol statements. 

OS,FILE,INDFILE,BT=C,RT=F 


OS,SKIPF,INDFILE,300000 


SEP ITEM-SIZE 


DISPLAY UPON INDFILE $CM0575$ $0006$ 


DISPLAY UPON INDFILE $SH0011$ $0004$ 


DISPLAY UPON INDFILE STY5015S $0012* 


DISPLAY UPON INDFILE SXN6158$ $0003$ 


DISPLAY FROM INDFILE IND-INV-NO IND-ON-ORDER A DISPLAY operation verifies that four 

records have been added to the file. 

AB5972 25 

CB0168 50 

YB0020 35 

B80013 40 

AB5975 22 

CH0060 33 

CM0575 6 

SH0011 4 

TY5015 12 

XN6158 3 

10 ACCESSES, 10 HITS, 10 IO-S 


OS,EXTEND,INDFILE Extend INDFILE and make the data permanent. 


END 


Figure 4-5. Entering Data Into a Non-Data-Base File Under NOS/BE 


Skip forward to position INDFILE at end-of- 
information. 

Indicate to Query Update to concatenate the 
fields. 

Enter four records in INDFILE and create a 
directory for INDFILE. 
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COMBINING DATA BASE AND NON-DATA-BASE 

FILE OPERATIONS 


5 


Section 3 introduces the MODIFY, STORE, and REMOVE 
directives and shows their use with data base files. 
The input source in each case was the user termi¬ 
nal. This section presents a variation of these 
directives and shows how they can be used to modify 
a data base file using a non-data-base file as the 
input source. Three operations can be performed: 

MODIFY ... FROM 

Modifies a data base file using data from a 
non-data-base file. 


REMOVE ... FROM 

Removes records from a data base file based 
on values contained in a non-data-base file. 

STORE ... FROM 

Stores data in a data base file using data 
from a non-data-base file. 

Whenever combined data base and non-data-base file 
operations are anticipated, the following require¬ 
ments must be met: 


A data base file key field value must appear in 
the non-data-base file. 


Information in a non-data-base file must be 
arranged in the order in which it is to be 
referenced in a Query Update directive. 

Data base file INVENTORY and non-data-base file 
INDFILE contain common fields: inventory number and 
amount on order. The following paragraphs describe 
modification of INVENTORY based on values contained 
in INDFILE. 


MODIFYING ACROSS FILES 

The INVENTORY ON-ORDER fields, which are assumed to 
be noncumulative, can be modified with values con¬ 
tained in the corresponding INDFILE IND-ON-ORDER 
fields. The MODIFY ... FROM directive performs 
this type of operation as shown in figure 5-1. 

INDFILE is appropriately attached and described and 
the subschema is named with the INVOKE directive. 
Displays against INVENTORY and INDFILE indicate the 
present status of the ON-ORDER fields. 

The SEP ITEM-SIZE directive tells Query Update to 
use the directory description (established by the 
DESCRIBE directive) to determine the size of each 
item in INDFILE. The MODIFY ... FROM directive 
specifies the INVENTORY file primary key field and 
the field to be modified. CYBER Record Manager 
(CRM) locates the appropriate data base record and 
Query Update moves the new value into the corre¬ 
sponding ON-ORDER field. A second display against 
INVENTORY shows that data records with primary keys 
AB5972, AB5975, BB0013, CB0168, CH0060, and YB0020 
reflect new totals for the ON-ORDER fields. 

The following should be noted about the MODIFY ... 
FROM directive: 


The fields specified in the USING option must 
be a primary or an alternate key field in the 
data base file. If a primary key is specified, 
only one record will be modified because the 
key value is unique. If an alternate key is 
specified, all records with the same value as 
the key are modified. 

The non-data-base file is automatically rewound 
before a MODIFY ... FROM directive is executed. 


Conditional testing on a data base field with 
the IF directive is not. allowed when the USING 
option has been specified. 
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/ QU 


Call Query Update. 

QUERY UPDATE 3.4 SYSEDIT-82110 82/05/03 10.09.16 


? 0$,ATTACH,INDFILE (UN=username) 

Issue operating system ATTACH and FILE 



control statements. NOS/BE requires an 

ID parameter instead of a UN parameter. 

? OS,FILE 

,INDFILE,BT=C,RT=F 


? DESCRIBE INDFILE AND IND-INV-NO AS CHAR BY $X(6)S + 

Establish the directory for INDFILE. 

? AND IND 

-ON-ORDER AS NUM BY SZ(3)9S 

? INVOKE 

QUSUB (UN-CAH0220) 

Name the subschema. 

? DISPLAY 

INV-NO ON-ORDER 


AB5972 

12 

This is the present status of INVENTORY 

AB5973 

7 

ON-ORDER fields. 

A85975 

12 


BB0013 

8 


CB0168 

0 


CB1002 

0 


CB1003 

0 


CB1004 

0 


CH0059 

6 


CH0060 

0 


CH0080 

0 


CHOI00 

2 


CH0575 

6 


SH0011 

3 


(MORE... 

? Y 

ANSWER Y OR N) 


TY5015 

0 


XN6158 

0 


Y80020 

0 


Y80060 

4 


18 

ACCESSES, 18 HITS, 18 IO-S 


? DISPLAY 

FROM INDFILE IND-INV-NO IND-ON-ORDER 


AB5972 

25 

This is the present status of INDFILE 

CB0168 

50 

IND-ON-ORDER fields. 

YB0020 

35 


BB0013 

40 


AB5975 

22 


CH0060 

33 


CH0575 

6 


SH0011 

4 


TY5015 

12 


XN6158 

3 


10 

ACCESSES, 10 HITS, 10 IO-S 


? SEP ITEM-SIZE 

Indicate that the $ is not present in 



INDFILE; Query Update must use the 



directory descriptions. 

? MODIFY 

USING INV-NO SETTING ON-ORDER FROM INDFILE 

Modify INVENTORY from INDFILE. 

9 

ACCESSES, 9 HITS, 18 IO-S 


Figure 5-1. Modifying INVENTORY From INDFILE (Sheet 1 of 2) 
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? DISPLAY 

INV-NO 0N-0RDER 

A display of INVENTORY shows that the 

AB5972 

25 

contents of nine 0N-0RDER fields have 

AB5973 

7 

changed. 

AB5975 

22 


BB0013 

40 


C80168 

50 


CB1002 

0 


CB1003 

0 


CB1004 

0 


CH0059 

6 


CH0060 

33 


CH0080 

0 


CHOI00 

2 


CH0575 

6 


SH0011 

4 


(MORE... 

ANSWER Y OR N) 


? Y 

TY5015 

12 


XN6158 

3 


YB0020 

35 


YB0060 

4 


18 

ACCESSES, 18 HITS, 18 I0-S 


? END 


Terminate Query Update. 


Figure 5-1. Modifying INVENTORY 


REMOVING ACROSS FILES 

Records can be removed from INVENTORY based on 
information contained in INDFILE. Removal is per¬ 
formed by the REMOVE ... FROM directive. Key field 
values in the non-data-base file are compared to 
key field values in the data base file; when the 
values match, the appropriate data base file record 
is removed. This type of operation is shown in 
figure 5-2. 

INDFILE is appropriately attached and described, 
and the subschema QUSUB is named with the INVOKE 
directive. A display of INVENTORY indicates the 
total number of records currently stored. 

The REMOVE ... FROM directive specifies the 
INVENTORY primary key field. CRM locates the data 
base record whose key field matches the non-data¬ 
base file field, and Query Update removes the data 
base record. A second display of INVENTORY reflects 
a new total, indicating that the removal took place. 

The following should be noted about the REMOVE ... 
FROM directive: 

A field specified in the USING option must be a 
primary or an alternate key field in the data 
base file. Additional fields, if included, are 
used for spacing in the file specified in the 
FROM clause. 

A non-data-base file is automatically rewound 
before a REMOVE ... FROM directive is executed. 

Conditional testing on a data base field with 
an IF directive is not allowed when the USING 
option has been specified. 


From INDFILE (Sheet 2 of 2) 


STORING ACROSS FILES 

Records in INDFILE can be stored into INVENTORY. 
The STORE ... FROM directive performs this type of 
operation as shown in figure 5-3. 


INDFILE is appropriately attached and described, 
and the subschema QUSUB is named with the INVOKE 
directive. A display of INVENTORY indicates the 
total number of records currently stored. 


The STORE ... FROM directive specifies the INVENTORY 
file primary key INV-NO field and the ON-ORDER 
field. Query Update stores the new record entries 
in the data base file. A second display of 
INVENTORY reflects a new total, indicating that the 
store took place. A display of inventory record 
AB5975 shows that Query Update numeric fields are 
zero filled and alphanumeric fields are blank 
filled. 


The following should be noted about the STORE ... 
FROM directive: 


The field specified in the SETTING option must 
be a primary or an alternate key field in the 
data base file. 

The non-data-base file is automatically rewound 
before a STORE ... FROM directive is executed. 

Conditional testing on a data base field with 
the IF directive is not allowed when the SETTING 
option has been specified. 
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/ QU 


QUERY UPDATE 3.4 SYSEDIT-82110 


82/05/03 10.09.16 


? OS,ATTACH,INDFILE (UN=username) 


? OS,FILE,INDFILE,BT=C,RT=F 


Issue operating system ATTACH and FILE 
control statements. NOS/BE requires 
an ID parameter instead of a UN 
parameter. 


? DESCRIBE INDFILE AND IND-INV-NO AS CHAR BY $X<6>$ + 
? AND IND-ON-ORDER AS NUN BY SZ(3)9$ 


Establish the directory for INDFILE. 


? INVOKE QUSUB (UN=CAH0220> 


? DISPLAY INV-NO 
AB5972 
AB5973 
A85975 
B60013 
CB0168 
CB1002 
CB1003 
CB1004 
CH0059 
CH0060 
CH0080 
CHOI 00 
CH0575 
SH0011 

(NORE... ANSWER Y OR N) 

? Y 

TY5015 

XN6158 

YB0020 

YB0060 

18 ACCESSES, 18 HITS, 18 IO-S 


Name the subschema. NOS/BE requires an 
ID parameter instead of a UN parameter. 

A display of INVENTORY primary key 
fields shows that 18 records are stored 
in the file. 


? SEP ITEN-SIZE 


Indicate that the $ is not present in 
INDFILE; Query Update must use the 
directory descriptions. 


? RENOVE USIN6 INV-NO FRON INDFILE 
10 ACCESSES, 10 HITS, 20 IO-S 


? DISPLAY INV-NO 
AB5973 
CB1002 
CB1003 
CB1004 
CH0059 
CH0080 
CHOI 00 
YB0060 

8 ACCESSES, 8 HITS, 8 IO-S 


Remove INVENTORY records whose primary 
key values equal those in INDFILE. 

The file is positioned at the beginning- 
of-information because no operation has 
been performed against INDFILE. 

A display of INVENTORY primary key 
fields shows that 10 records have been 
removed. 


Terminate Query Update, 


Figure 5-2. Removing INVENTORY Records Via INDFILE 
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/ QU 


QUERY UPDATE 3.4 SYSEDIT-82110 


82/05/03 10.09.16 


? OS,ATTACH,INDFILE (UN=username) 


? OS,FILE,INDFILE,BT=C,RT=F 


Issue operating system ATTACH and FILE 
control statements. NOS/BE requires an 
ID parameters instead of a UN parameter, 


? DESCRIBE INDFILE AND IND-INV-NO AS CHAR BY $X(6>$ + 
? AND IND-ON-ORDER AS NUN BY SZ(3)9$ 


Establish the directory for INDFILE. 


? INVOKE QUSUB <UN=XXXXXXX) 


? DISPLAY INV-NO ON-ORDER 
AB5973 7 

CB1002 0 

CB1003 0 

CB1004 0 

CH0059 6 

CH0080 0 

CHOI00 2 

YB0060 4 

8 ACCESSES, 8 HITS, 8 IO-S 


Name the subschema. NOS/BE requires an 
ID parameter instead of a UN parameter. 

A display of INVENTORY shows that 8 
records are stored in the file. 


? SEP ITEM-SIZE 


Indicate that the $ is not present in 
INDFILE; Query Update must use the 
directory descriptions. 


? STORE SETTIN6 INV-NO ON-ORDER FROM INDFILE 
10 ACCESSES, 10 HITS, 10 IO-S 


Store INDFILE records into INVENTORY. 


? DISPLAY INV-NO ON-ORDER 
AB5972 25 

AB5973 7 

AB5975 22 

BB0013 40 

CB0168 50 

C81002 0 

CB1003 0 

CB1004 0 

CH0059 6 

CH0060 33 

CH0080 0 

CHOI 00 2 

CH0575 6 

SH0011 4 

(MORE... ANSWER Y OR N) 

? Y 

TY5015 
XN6158 
YB0020 
YB0060 


A display of INVENTORY shows that 10 
records have been stored. 


18 ACCESSES, 18 HITS, 18 IO-S 


? IF INV-NO EQ SAB5975S DISPLAY INV-REC 
(209) REQUESTED DATA MAY NOT BE IN DISPLAY FORMAT 
AB59750000000000220000000000000000 

1 ACCESSES, 1 HITS, 2 IO-S 


A display of a stored record shows that 
Query Update zero filled numeric fields 
and blank filled alphanumeric fields. 


Terminate Query Update. 


Figure 5-3. Storing INVENTORY Records Via INDFILE 
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QUERY UPDATE REPORTS 
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A variety of Query Update directives are available 
for preparing and generating reports. Reports can 
be displayed at the terminal, printed on either a 
terminal hardcopy printer or a line printer, stored 
as permanent files, or any combination of the four. 

Reports can be generated from a data base or non- 
data-base file. Data for the report is retrieved 
according to a directory established at report time. 

Data base file report operations use a temporary 
directory that points to a subset of the data base 
file. The subset is a sequential file composed of 
the fields selected for the report. Both the file 
subset and the temporary directory are created by 
an EXTRACT directive. 

| Non-data-base file report operations use the direc¬ 
tory established by a DESCRIBE directive. 

Reports are named by the FORMAT directive. The 
layout directives that follow the FORMAT directive 
| provide the report titles, column headings, column 
positioning, page numbering, and so forth. 

Production of the report is initiated through a 
PREPARE directive. Operating system commands are 
used to direct the finished report to the desired 
output device. 

Reports shown in this section combine operations 
under NOS and NOS/BE. Some differences are the 
following: 

The operating system request for input. NOS 
prints a slash (/), NOS/BE prints the word 
COMMAND-. 

The permanent file parameters. Directives that 
reference permanent files require certain 
parameters, as shown in the figures. 

The permanent file storage commands. NOS 
requires DEFINE and COPY control statements, 
NOS/BE requires a CATALOG control statement. 

The report output commands. NOS requires a 
ROUTE control statement, NOS/BE requires a 
BATCH control statement. 

The commands for viewing reports at the termi¬ 
nal (not shown in figures). 

NOS requires you to enter the word EDIT, a 
comma, and the name of the report to be 
displayed. Then the text editor prints a 
heading and waits for input. You enter the 
word PRINT followed by an asterisk to 
display the entire report. Printing is 
terminated when you enter the word END. 


NOS/BE requires you to enter the word PAGE, 
a comma, and the name of the report to be 
displayed. Then the PAGE system prints a 
Ready message and waits for input. You 
enter the number of the first line to be 
displayed. Paging continues if you enter a 
plus sign (+), paging terminates if you 
enter the letter E for end. 

The general sequence of commands and directives for 
report generation is summarized in table 6-1. 
Reports prepared in this manner are referred to as 
one-time reports because they are available only 
during the current session. 


TABLE 6-1. SUMMARY OF BASIC COMMANDS AND 
DIRECTIVES FOR ONE-TIME REPORTING 


Non-Data-Base File 

Data Base File 

Operations 

Operations 

QU 

QU 

OSt,ATTACH,non-data- 

INVOKE,subschema ... 

base file ... 

EXTRACT 

0St,FILE ... 

FORMAT 

DESCRIBE 



. (layout directives) 

FORMAT 

• 

. (layout directives) 

PREPARE 


END 

PREPARE 

Output Commands 

END 


Output Commands 


tYou can enter the operating system ATTACH and 

FILE control statements 

, rather than the Query 

Update OS directives, before the QU control 

statement. 



The basic commands and directives for a one-time 
report from INVENTORY are shown in figure 6-1. 

The basic commands and directives for a one-time 
report from INDFILE are shown in figure 6-2. 

In most cases it is better to prepare report formats 
and store them as permanent files so they can be 
used over and over again. This convention is 
called cataloging and is described in the following 
paragraphs. 
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/ QU 


Call Query Update 


QUERY UPDATE 3.4 SYSEDIT-82110 82/05/04 15.04.07 


? INVOKE QUSUB (UN»userna«e) 

? EXTRACT UPON FILE1 INV-NO ON-ORDER 
18 ACCESSES, 18 HITS, 18 XO-S 

? FORMAT REP0RT1 

? DETAIL IS INV-NO IN COLUMN 7 ON-ORDER IN COLUMN 16 

? TITLE AT LINE 2 IS + 

? $ ONE-TIME DATA BASE FILE REPORTS + 

? AT LINE 3 IS $ S 

? PREPARE REP0RT1 FROM FILE1 

? ENO 

★★CAUTION** 

DEFAULT CATALOG REMAINS AS LOCAL FILE ZZZZZQ2 
/ ROUTE,REP0RT1,DC=PR 


Name the subschema. N0S/8E requires an ID 
parameter instead of a UN parameter. 

Build a two-field subset of INVENTORY and 
an associated directory. The subset 
sequential file is named FILE1. 

Supply the name of the report and indicate 
that layout directives follow. 

Supply the report line content and vertical 
positioning for the fields. 

Supply the report title and specify hori¬ 
zontal positioning on line 2. A blank line 
is to appear at line 3. 


Generate REP0RT1 using data from FILE!. 


Terminate Query Update. 


NOS/BE control statement would be the 
following: COMMAND- BATCH,REP0RT1,PRINT 


ONE-TIME DATA BASE FILE REPORT 


AB5972 9 
AB5973 0 
AB5975 3 
860013 8 
CB0168 0 
CB1001 0 
CB1003 0 
C81005 0 
CH0059 6 
CH0060 0 
CH0080 0 
CH0575 6 
SH0011 3 
ST0592 0 
TY5015 0 
XN6158 0 
YB0020 0 
YB0060 4 


** END OF REPORT REP0RT1 ** 


Figure 6-1. Generating a One-Time Report From INVENTORY 
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/ QU 


Call Query Update. 


QUERY UPDATE 3.4 SYSEDIT-82110 82/05/12 15.32.30 


? OS,ATTACH,INDFILE (UN=username) 

? OS,FILE,INDFILE,BT=C,RT=F 

? DESCRIBE INDFILE AND IND-INV-NO AS CHAR BY $X(6)$ + 
? AND IND-ON-ORDER AS NUN BY $Z(3)9$ 

? FORHAT REP0RT2 

? DETAIL IS IND-INV-NO IN COLUHN 7 + 

? IND-ON-ORDER IN COLUNN 16 


? TITLE AT LINE 2 IS + 

? SONE-TINE INDEPENDENT FILE REPORTS + 

? AT LINE 3 IS S S 

? PREPARE REP0RT2 FRON INDFILE 

? END 

♦♦CAUTION** 

DEFAULT CATALOG RENAINS AS LOCAL FILE ZZZZZQ2 
/ ROUTE,REP0RT2,DC=PR 


Attach INDFILE and declare file organiza¬ 
tion for CRM. NOS/BE requires an ID param¬ 
eter instead of a UN parameter. 


Establish the directory for INDFILE. 


Supply the name of the report and indicate 
that layout directives follow. 

Supply report line content and vertical 
positioning for the fields. 


Supply report title and specify horizontal 
positioning on line 2. A blank line is to 
appear at line 3. 


Rewind INDFILE and execute REP0RT2 
directives. 

Terminate Query Update. 


NOS/BE control statement would be the 
following: COMMAND- BATCH,REP0RT2,PRINT 


ONE-TINE INDEPENDENT FILE REPORT 


AB5972 

25 

CB0168 

50 

YB0020 

35 

B80013 

40 

AB5975 

33 

CH0060 

33 


** END OF REPORT REPORT2 ** 


Figure 6-2. Generating a One-Time Report From INDFILE 


QUERY UPDATE CATALOGS 

Report directives are stored on a local file named 
ZZZZZQ2, which is known as the default catalog. At 
the beginning of each new Query Update session 
(that is, whenever the QU control statement is 
entered), the previous default catalog is returned 
to the operating system and a new default catalog 
is made available. This means that the report 
directives entered on the default catalog for one 


session cannot be made available for another ses¬ 
sion. All report directives for that specific 
report must be entered again. 

This problem is solved by storing the default 
catalog as a permanent file. When the report is 
needed at a later time, the permanent catalog can 
be attached, the Query Update session directives 
initiated, and the report generated with minimum 
effort. 
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CATALOGING REPORTS 

| Recording Query Update sessions on a permanent 
catalog represents an efficient method of gener¬ 
ating reports. Report directives need to be entered 
once, then the report itself can be generated over 
and over again. Reports can always be changed, 
even after they are cataloged. The ALTER direc¬ 
tive, which is discussed later in this section, 
accepts subsequent directives that remove, replace, 
or add report specifications to the cataloged 
report. 

The general sequence of commands and directives for 
cataloging reports is summarized in table 6-2. 

TABLE 6-2. SUMMARY OF BASIC COMMANDS AND 
DIRECTIVES FOR CATALOGING REPORTS 


Non-Data-Base File 

Data Base File 

Operations 

Operations 

QU 

QU 

OSt.ATTACH,non-data¬ 
base file, ...t 

RECORDING 

INVOKE subschema ...tt 

OS,FILE, ...t 

EXTRACT 

RECORDING 

PREPARE 

DESCRIBE 

ENDttt 

PREPARE 

RECORDING OFF 

ENDttt 

FORMAT 

RECORDING OFF 



. (layout directives) 

FORMAT 

• 

. (layout directives) 

END 


Permanent File 

END 

Storage Commands 

Permanent File 

Storage Commands 


tYou can use the operating system ATTACH and 

FILE statements, rather than the Query Update 

OS directives, before 

the QU control state- 

ment. The OS directives can be positioned 

I immediately after the 

RECORDING directive and 

be recorded as part of a session. 

ttlhe INVOKE directive can follow the QU control 

statement and remain outside of the recording 

limits. 


tttThe END directive within the recording limits 

is optional. When this directive is included, 
control reverts to the operating system 

immediately after the 

cataloged session is 

subsequently performed. When this directive 
is omitted, control remains with Query Update. 


Notice that the FORMAT directive initiates reten¬ 
tion of the associated layout directives. These 
directives are retained in the catalog under the 
report name specified in the FORMAT directive. 


Figure 6-3 shows the basic commands and directives 
for cataloging a report from INVENTORY. 


Figure 6-4 shows the basic commands and directives 
for cataloging a report from INDFILE. 


USING CATALOGED REPORTS 

Cataloged reports can be produced with a minimum of 
two directives: VERSION and PERFORM. The VERSION 
directive attaches the named permanent catalog. 
The PERFORM directive retrieves and executes the 
directives recorded under the named session. The 
general sequence of commands and directives for 
using cataloged reports is summarized in table 6-3. 


TABLE 6-3. SUMMARY OF BASIC COMMANDS AND 
DIRECTIVES FOR USING CATALOGED REPORTS 


Non-Data-Base File 

Data Base File 

Operations 

Operations 

QU 

QU 

OS,ATTACH,non—d at a— 
base file ...t 

VERSION ... 


PERFORM 

VERSION 

Report Disposition 

PERFORM 

Commands 

Report Disposition 
Commands 



tlhe ATTACH and FILE control statements can 
assume three positions: before the QU con¬ 
trol statement as normal operating system 
control statements, after the QU control 
statement as Query Update OS directives, 
or within the recorded session called by 
the Query Update VERSION directive. 


Figure 6-5 shows the generation of data base file 
REP0RT3 from the QUCAT catalog. 


Figure 6-6 shows the generation of non-data-base 
file REP0RT4 from the QUCAT catalog. 


When the VERSION directive references the permanent 
catalog, some permanent file parameters are re¬ 
quired as shown in the figures. 


6-4 
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/ au 


Cal 1 Query Update. 


QUERY UPDATE 3.4 SYSEDIT-82110 82/05/12 16.42.18 


? REC0RDIN6 SESS3 
001 — 

? INVOKE QUSUB (UN=username) 

002 — 

? EXTRACT UPON FILE3 INV-NO ON-ORDER 
003— 

? PREPARE REP0RT3 FROM FILE3 

004— 

? END 

005— 

? RECORDING OFF 

END OF SESSION SESS3 


? FORMAT REP0RT3 


? DETAIL IS INV-NO IN COLUMN 7 + 
? ON-ORDER IN COLUMN 16 


? TITLE AT LINE 2 IS + 

? (RECORDED DATA BASE FILE REPORTS + 
? AT LINE 3 IS $ $ 


? END 


**CAUTION** 

DEFAULT CATALOG REMAINS AS LOCAL FILE ZZZZZQ2 


/ DEFINE,QUCAT 
/ C0PY,ZZZZZQ2,QUCAT 


Initiate recording of session and name it 
SESS3. 

Name the subschema. NOS/BE requires an ID 
parameter instead of a UN parameter. 


Terminate execution of SESS3. 


Terminate the recording session, 


Supply the name of the report. 


Terminate Query Update. 


NOS/BE control statements would be the 
following: 

COMMAND- CATALOG,ZZZZZQ2,QUCAT,ID=QUSER 


Figure 6-3. Cataloging a Report Fro* INVENTORY 


/ QU 

QUERY UPDATE 3.4 SYSEDIT-82110 82/05/12 16.55.44 

? OS,ATTACH,INDFILE <UN=username) 

? OS,FILE,INDFILE,BT=C,RT=F 

? RECORDING SESS4 
001 — 

? DESCRIBE INDFILE AND IND-INV-NO AS CHAR 8Y SX(6)$ + 
? AND IND-ON-ORDER AS NUM BY $Z(3)9$ 

002 — 

? PREPARE REP0RT4 FROM INDFILE 

Figure 6-4. Cataloging a Report 
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Call Query Update. 


Attach INDFILE. NOS/BE requires an ID 
parameter instead of a UN parameter. 

Declare file organization for CRM. 


Initiate recording and name the session 
SESS4. 

Query Update prints transmission IDs 
numbered sequentially from 001. Each 
executable directive is entered for a 
report named REP0RT4. 


From INDFILE (Sheet 1 of 2) 
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003— 

? END 

004— 

? RECORDING OFF 

END OF SESSION SESS4 


? FORMAT REP0RT4 


? DETAIL IS IND-INV-NO IN COLUMN 7 + 
? IND-ON-ORDER IN COLUMN 16 


? TITLE AT LINE 2 IS + 

? (RECORDED NON-DATA-BASE FILE REPORTS + 
? AT LINE 3 IS $ S 


? END 


**CAUTION** 

DEFAULT CATALOG REMAINS AS LOCAL FILE ZZZZZQ2 

/ DEFINE,QUCAT 
/ C0PY,ZZZZZQ2,0UCAT 


Terminate execution of SESS4. 


Terminate the recording session. 


Supply the name of the report. 


Terminate Query Update. 


NOS/BE control statement would be the 
following: 

COMMAND- CATAL0G,ZZZZZQ2,QUCAT,ID=QUSER 


Figure 6-4. Cataloging a Report From INDFILE (Sheet 2 of 2) 


/ QU 

OJERY UPDATE 3.4 SYSEDIT-82110 82/05/17 10.35.49 


? VERSION BUCAT (UN=username) 


? PERFORM SESS3 


? END 


/ ROUTE,REP0RT3,DC=PR 


RECORDED DATA BASE FILE REPORT 


AB5972 9 
AB5973 0 
AB5975 3 
660013 8 
CB0168 0 
CB1001 0 
CB1003 0 
CB1005 0 
CH0059 6 
CH0060 0 
CH0080 0 
CMOS75 6 
SH0011 3 
ST0592 0 
TY5015 0 
XN6158 0 
YB0020 0 
YB0059 0 
YB0060 4 

** END OF REPORT REP0RT3 ** 


Figure 6-5. Generating Data Base Fil 


Call Query Update. 


Attach the permanent catalog QUCAT. 
N0S/8E requires an ID parameter instead 
of the UN parameter. 

Retrieve and execute the directives 
recorded under SESS3. 

Terminate Query Update. 


NOS/BE control statement would be the 
following: COFftAND- BATCH,REP0RT3,PRINT 


REP0RT3 From a Permanent Catalog 
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/ QU 


Call Query Update. 


QUERY UPDATE 3.4 SYSEDIT-82110 82/05/17 10.58.11 


? OS,ATTACH,INDFILE (UN=username) 


? OS,FILE,INDFILE,BT=C,RT=F 


Attach INDFILE. NOS/BE requires an ID 
parameter instead of a UN parameter. 

Declare the file organization for CRM. 


? VERSION QUCAT (UN=username) 


? PERFORM SESS4 


? END 


/ R0UTE,REP0RT4,DC-PR 


RECORDED NON-DATA-BASE FILE REPORT 


AB5972 

25 

CB0168 

50 

YB0020 

35 

BB0013 

40 

AB5975 

22 

CH0060 

33 


** END OF REPORT REP0RT4 ** 


Attach the permanent file catalog. NOS/BE 
requires an ID parameter instead of a UN 
parameter. 

Retrieve and execute the directives recorded 
under SESS4 (refer to figure 6-4). 

Terminate Query Update. 

NOS/BE control statement would be the 
following: COMMAND- BATCH,REP0RT4,PRINT 


Figure 6-6. Generating Non-Data-Base File REP0RT4 From a Permanent Catalog 


DUPLICATING CATALOGED REPORTS 

Reports that are recorded on a permanent catalog 
can be duplicated on the default catalog. Con¬ 
versely, reports that are recorded on the default 
catalog can be duplicated on a permanent catalog. 
Session names, report names, and transmission IDs 
(the three-digit number appended to a directive at 
recording time) can be selected for duplication. 

A duplicate report operation from the default cata¬ 
log to the permanent catalog is shown in figure 6-7. 


This option is a convenient way to add reports to 
an existing permanent catalog. 


A duplicate report operation from the permanent 
catalog to the default catalog is shown in figure 
6-8. This option is a convenient way to access 
cataloged report formats that require modification 
for one-time use. Changes can be made to the 
duplicated report format on the default catalog 
without affecting the report format stored on the 
permanent file catalog. 


/ QU Call Query Update. 

QUERY UPDATE 3.4 SYSEDIT-82110 82/05/17 13.24.17 

? RECORDING SESS5 
001 -- 

? INVOKE QUSUB (UN=username) 

002 — 

? EXTRACT UPON FILE5 INV-N0 0N-0RDER 
003— 

? PREPARE REP0RT5 FROM FILE5 

Figure 6-7. Duplicating a Report From a Default to a Permanent Catalog (Sheet 1 of 2) 
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Initiate recording of a session and name 
it SESS5. 

Name the subschema. NOS/BE requires an ID 
parameter instead of a UN parameter. 






004— 

? END 

005 — 

? RECORDING OFF 

END OF SESSION SESS5 


? FORMAT REP0RT5 


? DETAIL IS INV-NO IN COLUMN 7 + 
? ON-ORDER IN COLUMN 16 


? TITLE AT LINE 2 IS + 

? (DUPLICATED REPORTS IN COLUMN 7 + 
? AT LINE 3 IS $ $ 


? VERSION QUCAT (UN=username/M=W) 


? DUPLICATE SESSION SESS5 


? DUPLICATE REPORT REP0RT5 


? PERFORM SESS5 


? END 


**CAUTION** 

DEFAULT CATALOG REMAINS AS LOCAL FILE ZZZZZQ2 
/ ROUTE,REPORTS,OC=PR 


DUPLICATED REPORT 

AB5972 9 

AB5973 0 

AB5975 3 

860013 8 

C60168 0 

CB1001 0 

CB1003 0 

CB1005 0 

CH0059 6 

CH0060 0 

CH0080 0 

CM0575 6 

SH0011 3 

ST0592 0 

TY5015 0 

XN61S8 0 
YB0020 0 

YB0059 0 

YB0060 4 

** END OF REPORT REPORTS ** 


REP0RT5 is formatted on the default 
catalog. 


Attach the QUCAT catalog. NOS/BE requires 
an ID parameter instead of a UN parameter. 

Copy SESS5. 


Copy REPORTS. 


Retrieve and execute the directives 
recorded on permanent file catalog QUCAT. 


Terminate Query Update. 


NOS/BE control statement would be the 
following: COMMAND- BATCH.REP0RT5,PRINT 


Figure 6-7. Duplicating a Report From a Default to a Permanent Catalog (Sheet 2 of 2) 
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/ QU 


Call Query Update 


QUERY UPDATE 3.4 SYSEDIT-82110 82/05/17 14.12.10 


? VERSION QUCAT (UN=username> 


? DUP UPON DEFAULT SESSION SESS3 AS DUP3 


? DUP UPON DEFAULT REPORT REP0RT3 


? VERSION DEFAULT 


? PERFORM 0UP3 


? END 


♦♦CAUTION** 

DEFAULT CATALOG REMAINS AS LOCAL FILE ZZZZZQ2 
/ ROUTE,REP0RT3,DC=PR 


RECORDED DATA BASE FILE REPORT 

AB5972 9 

AB5973 0 

AB5975 3 

B80013 8 

CB0168 0 

CB1001 0 

CB1003 0 

CB1005 0 

CH0059 6 

CH0060 0 

CH0080 0 

CM0575 6 

SH0011 3 

ST0592 0 

TY5015 0 

XN6158 0 

YB0020 0 

YB0059 0 

YB0060 4 

** END OF REPORT REP0RT3 ** 


Figure 6-8. Duplicating a Report From 


Attach the permanent file catalog QUCAT. 
NOS/BE requires an ID parameter instead of 
a UN parameter. 

Copy SESS3. 


Copy REP0RT4. 


Future PERFORM directives will use the 
default catalog. 

Retrieve and execute the directives dupli¬ 
cated on the default catalog. Notice that 
the new session name DUP3 is used; SESS3 
would not be found on the default catalog. 

Terminate Query Update. 


NOS/BE control statement would be the 
following: COMMAND- BATCH,REP0RT3,PRINT 


a Permanent to a Default Catalog 
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ALTERING REPORTS 

Report formats can be altered by adding or removing 
one or more layout directives. The report whose 
format is to be altered can reside on the permanent 
or default catalog. The operation la Initiated by 
the ALTER directive, which names the report. The 
directives that Immediately follow effect the 
changes. 

Adding a Directive 

A new directive Is to be added to REP0RT3. Each 
time the report Is produced, the system is to 


supply the data and position it on the title line 
at column 45. The addition of the new directive is 
shown in figure 6-9. 

The QUCAT catalog on which REP0RT3 resides is 
attached with the VERSION directive. The report to 
be altered is named with the ALTER directive. The 
horizontal and vertical positioning of the date is 
supplied with the DATE directive. 

Report modification ends when a directive not asso¬ 
ciated with report modification is entered. Since 
the PERFORM directive is not related to report 
modification, no further modifications are made. 
The subsequent report reflects the current date. 


/ QU 


Call Query Update. 

QUERY UPDATE 3.4 SYSEDIT-82110 82/05/17 

14.45.09 


? VERSION QUCAT (UN=username/M=U) 


Attach the permanent file catalog QUCAT. 

NOS/BE requires an ID parameter instead of 



a UN parameter. 

? ALTER REP0RT3 


Locate the report directives for REP0RT3. 

? DATE AT TITLE-LINE COLUMN 45 


Add the DATE directive to the report. DATE 
specifies the current date, which is sup- 



plied by the system. 

? PERFORM SESS3 


Terminate report modification, retrieve and 
execute SESS3. The report will now have 
the current date each time it is prepared 



and output. 

? END 


Terminate Query Update. 

/ ROUTE,REP0RT3,DC=PR 


NOS/BE control statement would be the 
following: COMMAND- BATCH,REP0RT3.PRINT 

RECORDED DATA BASE FILE REPORT 

AB5972 9 

AB5973 0 

AB5975 3 

B60013 8 

CB0168 0 

CB1001 0 

CB1003 0 

81 / 06/17 


CB1005 0 

CH0059 6 

CH0060 0 

CH0080 0 

CM0575 6 

SH0011 3 

ST0592 0 

TY5015 0 

XN6158 0 

YB0020 0 

YB0059 0 

Y80060 4 

** END OF REPORT REP0RT3 ** 




Figure 6-9. Adding a Directive to a Report 
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Erasing a Directive 

A new title is to be given to REP0RT3. The present 
TITLE directive is to be removed and a new TITLE 
directive is to be stored. The use of the ERASE 
directive is shown in figure 6-10. 

The QUCAT catalog on which REP0RT3 resides is 
attached with the VERSION directive and the report 


to be altered is named with the ALTER directive. 
The ERASE directive indicates the TITLE directive 
is to be removed. Query Update erases the direc¬ 
tive and prints its contents. The TITLE directive 
adds a new title. The PERFORM directive terminates 
modification and executes the session. 

The subsequent report reflects the new title. 


/ QU 

QUERY UPDATE 3.4 SYSEDIT-82110 82/05/17 14.52.45 


? VERSION QUCAT (UN=username/M=W) 


? ALTER REP0RT3 


? ERASE REPORT REP0RT3 TITLE 

TITLE AT LINE 2 IS SRECORDED DATA BASE 
FILE REPORTS AT LINE 3 IS $ S 


? TITLE AT LINE 2 IS + 

? SALTERED DATA BASE FILE REPORTS + 
? AT LINE 3 IS S $ 


? PERFORM SESS3 


? END 


/ ROUTE,REP0RT3,DC=PR 


ALTERED DATA BASE FILE REPORT 81/06/17 

AB5972 9 

AB5973 0 

AB5975 3 

B0OO13 8 
CB0168 0 

CB1001 0 

CB1003 0 

CB1005 0 

CH0059 6 

CH0060 0 

CH0080 0 

CM0575 6 

SH0011 3 

ST0592 0 

TY5015 0 

XN6158 0 

YB0020 0 

YB0059 0 

YB0060 4 

** END OF REPORT REP0RT3 ** 


Figure 6-10. Erasing a D 


Call Query Update. 

Attach the permanent file catalog QUCAT. 
NOS/BE requires an ID parameter instead of 
a UN parameter. 

Locate the report directives for REP0RT3. 

Request the title line to be erased. 

Query Update erases the title line after 
printing its contents. 

Supply a new title line. 

Terminate report modification. Retrieve 
and execute the directives in SESS3. 

Terminate Query Update. 

NOS/BE control statement would be the 
following: COMMAND- BATCH,REP0RT3.PRINT 


irective From a Report 
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SAMPLE REPORTS 

Sample reports are shown on the following pages• 
All reports are recorded on the permanent catalog 
QUCAT and the reference data base file INVENTORY. 
For NOS, the write permission mode parameter (M*W) 
must be Included on the VERSION directive for both 
the owner and the alternate user. Many of the 
Query Update directives that appear in the reports 
will be familiar because they have already been 
discussed in relation to cataloging operations. 
For this reason, only new directives are detailed 
in the figures. 


Figure 6-11 is a sample report that extracts infor¬ 
mation from four fields, sorts the information on 
the IN-STOCK field, positions the information in 
four columns, and supplies the title, date, and 
time. This report shows the most commonly used 
report directives and introduces two other direc¬ 
tives: SORT and TIME. 


Figure 6-12 is a sample report that shows the 
definition of a temporary item. As mentioned in an 
earlier section, a temporary item is one of the 
three categories of data handled by Query Update. 


This report defines temporary item PROFIT-MARGIN 
and uses it to calculate entries for one of the 
report columns. Three directives are introduced: 
DEFINE, TABS, and EVALUATE. 

Figure 6-13 is a sample report that presents one of 
many possible applications for the universal char¬ 
acter. This report declares the asterisk as the 
universal character and uses it for special testing 
against the INV-NO field. Three directives are 
introduced: UNIVERSAL, SPECIFY, and SELECT. 

Figure 6-14 is a sample report that extracts infor¬ 
mation from four fields, sorts the information on 
the IN—STOCK field, and specifies a break condition 
based on the contents of that field. Three direc¬ 
tives are introduced: HEADING, PAGE-NUMBER, and 
BREAK. 

Figure 6-15 is a sample report that specifies 
vertical positioning for the output report. Two 
directives are introduced: PAGE-SIZE and RECAP. 

Figure 6-16 is a sample report that shows how lines 
of text can be designated to precede and follow a 
report. Two directives are introduced: PREFACE 
and SUMMARY. 


/ QU 

QUERY UPDATE 3.4 SYSEDIT-82110 82/05/17 15.51. 


? VERSION QUCAT (UN=username) 


? RECORDING SESS6 
001 — 

? INVOKE QUSUB (UN=username) 

002 — 

? EXTRACT UPON FILE6 INV-NO DESCRIPTION + 
? IN-STOCK UNIT-PRICE 

003 — 

? REWIND FILE6 S0RT6 
004— 

? SORT FILE6 UPON S0RT6 ON IN-STOCK 
005— 

? PREPARE REP0RT6 FROM S0RT6 
006— 

? RECORDING OFF 

END OF SESSION SESS6 


? FORMAT REP0RT6 


? DETAIL IS IN-STOCK IN COLUMN 1 + 
? INV-NO IN COLUMN 11 + 

? DESCRIPTION IN COLUMN 24 + 

? UNIT-PRICE IN COLUMN 48 


Figure 6-11. Sample Report IUustrati 


Call Query Update. 

Attach the permanent catalog. N0S/8E 
requires an ID parameter instead of a UN 
parameter. 

Begin recording session SESS6. 

Name the subschema. NOS/BE requires an ID 
parameter instead of a UN parameter. 

Extract four fields from FILE6. 

Rewind FILE6 and the file to be used for 
sorting operations. 

Resequence records in FILE6 and place them 
on file S0RT6. 

Prepare REP0RT6 from the sorted file. 

Terminate recording of SESS6. 

Format a report named REP0RT6. 

Supply the report line content. 

the Basic Directives (Sheet 1 of 2) 
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Supply the report title. 


? TITLE AT LINE 1 IS + 

? SBASIC REPORTS IN COLUMN 24 + 
? AT LINE 2 IS $ $ 


? DATE AT TITLE-LINE COLUMN 60 

? TIME AT LINE 2 COLULMN 60 

? PERFORM SESS6 

? END 

/ ROUTE,REP0RT6,DC=PR 




BASIC REPORT 


2 

AB5973 

OAK DESK 

1282.50 

2 

AB5975 

WALNUT DESK 

1300.00 

2 

TY5015 

ELECT TYPEWRITER 

369.00 

5 

AB5972 

METAL DESK 

389.95 

5 

CH0060 

DESK CHAIR 

149.95 

7 

CH0059 

ARM CHAIR 

295.00 

7 

ST0592 

STOOL 

16.20 

8 

CB0168 

CHALK BOARD 

19.52 

9 

CH0080 

SWIVEL CHAIR 

96.00 

10 

BB0013 

BULLETIN BOARD 

15.00 

10 

CB1001 

1-DR FILE CABINET 

45.00 

10 

CB1003 

3-DR FILE CABINET 

60.00 

10 

CB1005 

5-DR FILE CABINET 

90.00 

10 

SH0011 

3-SHELF BOOK CASE 

39.95 

10 

XN6158 

COFFEE TABLE 

95.00 

20 

YB0060 

TABLE LAMP 

39.95 

25 

YB0059 

FLOOR LAMP 

69.95 

50 

CM0575 

LETTER RACK 

3.98 

500 

YB0020 

DESK LAMP 

19.95 


** 

END OF REPORT REPORT6 ** 



Request output of the current date. 


Request output of the current time. 


Retrieve and execute SESS6, which contains 
the directives in REP0RT6. 


Terminate Query Update. 

NOS/BE control statement would be the 
following: COMMAND- BATCH,REP0RT6,PRINT 


81/06/17 

15.57.27 


Figure 6-11. Sample Report Illustrating the Basic Directives (Sheet 2 of 2) 


/ QU Call Query Update. 

QUERY UPDATE 3.4 SYSEDIT-82110 82/05/18 09.15.12 

? VERSION QUCAT <UN=username) 

? RECORDING SESS7 
001 — 

? INVOKE QUSUB (UN=username) 

002 -- 

? EXTRACT UPON FILE? DESCRIPTION + 

? UNIT-PRICE UNIT-COST 

Figure 6-12. Sample Report Illustrating the Definition of a Temporary Data Item (Sheet 1 of 2) 


Attach the permanent file catalog. NOS/BE 
requires an ID parameter instead of a UN 
parameter. 

Begin recording session SESS7. 


Name the subschema. NOS/BE requires an ID 
parameter instead of a UN parameter. 

Extract three fields upon FILE7. 
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003— 

? DEFINE PROFIT-MARGIN BY $Z(6)99$ = + 

•> (UNIT-PRICE - UNIT-COST) / UNIT-COST * 100 


004-- 

? PREPARE REP0RT7 FROM FILE7 

005— 

? END 

006— 

? RECORDING OFF 

END OF SESSION SESS7 


? FORMAT REP0RT7 


? TABS AT 1 20 


? EVALUATE BEFORE ANY DETAIL PROFIT-MARGIN 


? DETAIL IS DESCRIPTION IN TAB 1 + 
? PROFIT-MARGIN IN TAB 2 


? TITLE AT LINE 1 IS STEMPORARY ITEM REPORTS + 

? IN COLUMN 6 AT LINE 2 IS * S + 

? AT LINE 3 IS SITEM* IN TAB 1 + 

? IS SPROFIT MARGINS IN TAB 2 AT LINE 4 IS S S 


? PERFORM SESS7 


? END 

/ R0UTE,REP0RT7,DC=PR 


TEMPORARY ITEM REPORT 


ITEM 

PROFIT MARGIN 

METAL DESK 

122 

OAK DESK 

157 

WALNUT DESK 

44 

BULLETIN BOARD 

200 

CHALK BOARD 

144 

1-DR FILE CABINET 

200 

3-DR FILE CABINET 

200 

5-DR FILE CA8INET 

181 

ARM CHAIR 

127 

DESK CHAIR 

68 

SWIVEL CHAIR 

174 

LETTER RACK 

306 

3-SHELF BOOK CASE 

100 

STOOL 

71 

ELECT TYPEWRITER 

12 

COFFEE TABLE 

150 

DESK LAMP 

263 

FLOOR LAMP 

278 

TABLE LAMP 

200 


** END OF REPORT REP0RT7 ** 
Figure 6-12. Sample Report Illustrating the Defi 


Establish a temporary data item named 
PROFIT-MARGIN. The value of the item is a 
mathematical expression that is to be 
evaluated by Query Update. 

Prepare REP0RT7 from the extracted file. 


Terminate execution of SESS7. 


Terminate recording of SESS7. 


Format a report named REP0RT7. 


Establish tab positions at columns 1 and 
20 for the report layout. 


Perform the mathematical operation indi¬ 
cated in the above DEFINE directive. 

Supply the report line content. 


Supply the report title and set up two 
column headings. 


Retrieve and execute SESS7. 


Terminate Query Update. 

NOS/BE control statement would be the 
following: COMMAND- BATCH,REP0RT7,PRINT 


nition of a Temporary Data Item (Sheet 2 of 2) 
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/ QU 


Cal 1 Query Update. 


QUERY UPDATE 3.4 SYSEDIT-82110 82/05/18 09.58. 


? VERSION QUCAT (UN=username) 


? RECORDING SESS8 
001 — 

? INVOKE QUSU6 CUN=username) 

002 — 

? EXTRACT UPON FILES DESCRIPTION + 
? INV-NO IN-STOCK 

003 — 

? UNIVERSAL IS * 


004— 

? SPECIFY CHAIRS AS INV-NO EQ $CH****$ 


005 — 

? PREPARE REP0RT8 FROM FILE8 
006— 

? RECORDING OFF 

END OF SESSION SESS8 


? FORMAT REP0RT8 


? SELECT 1 ON CHAIRS 


? DETAIL 1 IS DESCRIPTION IN COLUMN 3 + 
? IN-STOCK IN COLUMN 21 


? TITLE AT LINE 1 IS SUNIVERSAL CHARACTER REPORTS + 
? AT LINE 2 IS $ S AT LINE 3 IS SITEMS IN COLUMN 
? IS SIN STOCKS IN COLUMN 21 AT LINE 4 IS $ S 


? PERFORM SESS8 


? END 


/ ROUTE,REP0RT8,DC=PR 

UNIVERSAL CHARACTER REPORT 

ITEM IN STOCK 

ARM CHAIR 7 

DESK CHAIR 5 

SWIVEL CHAIR 9 

** END OF REPORT REP0RT8 ** 


Figure 6-13. Sample Report Illu 


Attach the permanent file catalog. NOS/BE 
requires an ID parameter instead of a UN 
parameter. 

Begin recording SESS8. 


Name the subschema. NOS/BE requires an ID 
parameter instead of a UN parameter. 

Extract three fields upon FILE8. 


Establish a character (*) that marks a 
character position to be ignored during 
comparison testing. 

Establish a name for convenient reference 
to a condition. The condition name in 
this directive is CHAIRS. The condition 
is an inventory number (INV-NO) whose 
first two characters are equal to CH. The 
universal character prohibits testing on 
the last four character positions of INV-NO 

Prepare REP0RT8 from the extracted file. 


Terminate recording of SESS8. 


Format a report named REPORTS. 


Test each record to see if it satisfies 
the condition in the SPECIFY directive. 

Supply the report line content. 


Supply the report title and set up two 
+ column headings. 


Retrieve and execute the directives in 
SESS8. 

Terminate Query Update. 


NOS/BE control statement would be the 
following: COMMAND- BATCH,REP0RT8,PRINT 


rating the Universal Character 


60499000 C 


6-15 • 



/ ou 


Cal 1 Query Update 


OUERY UPDATE 3.4 SYSEDIT-82110 82/05/18 14.50.02 


? VERSION QUCAT CUN=username) 


? RECORDING SESS9 
001 -- 

? INVOKE QUSUB (UN=username) 

002 — 

? EXTRACT UPON FILE9 INV-NO DESCRIPTION + 
? IN-STOCK UNIT-PRICE 

003 — 

? REWIND FILE9 S0RT9 
004 — 

? SORT FILE9 UPON S0RT9 ON IN-STOCK 
005 — 

? PREPARE REP0RT9 FROM S0RT9 
006— 

? RECORDING OFF 

END OF SESSION SESS9 


Attach the permanent file catalog. NOS/BE 
requires an ID parameter instead of the UN 
parameter. 

Begin recording SESS9. 

Name the subschema. NOS/BE requires an ID 
parameter instead of the UN parameter. 

Extract four fields upon FILE9. 

Rewind FILE9 and the file to be used for 
sorting operations. 

Sort FILE9 on the IN-STOCK field. 

Prepare REP0RT9 from the sorted file. 
Terminate recording of SESS9. 


? FORMAT REP0RT9 


Format a report named REP0RT9. 


? DETAIL IS IN-STOCK IN column 1 + Supply the report line content. 

? INV-NO IN COLUMN 11 + 

? DESCRIPTION IN COLUMN 24 + 

? UNIT-PRICE IN COLUMN 48 


? title AT LINE 1 IS + Supply the report title. 

? SBREAK ON ITEM REPORTS IN COLUMN 21 


? HEADING 0 AT LINE 5 BEYOND ON ALL PAGES + 
? IS SIN STOCKS IN COLUMN 1 + 

? IS SPART NOS IN COLUMN 11 + 

? IS SDESCRIPTIONS IN COLUMN 24 + 

? IS SPRICES IN COLUMN 48 + 

? AT LINE 6 BEYOND ON ALL PAGES + 


? IS S-$ IN COLUMN 1 + 

? IS $-$ in COLUMN 11 + 

? IS S-$ IN COLUMN 24 + 

? IS S-S IN COLUMN 48 + 


? AT LINE 7 BEYOND ON ALL PAGES IS $ $ 

? PAGE-NUMBER AT TITLE-LINE COLUMN 60 

? BREAK 1 AND EJECT ON ITEM IN-STOCK 


? PERFORM SESS9 

? END 


Specify the content and positioning of a 
heading. The level number 0 indicates 
that the heading is to appear before any 
input data is processed. The heading is to 
appear on each page of the report. 


Indicate vertical and horizontal position¬ 
ing of page numbers. 

Establish when the body of the report page 
is to be interrupted for a heading or foot¬ 
ing. The break occurs when the content of 
IN-STOCK changes. A printer page-eject is 
included. 

Retrieve and execute SESS9. 


Terminate Query Update. 


Figure 6-14. Sample Report Illustrating a Break on an Item (Sheet 1 of 3) 
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/ ROUTE,REP0RT9,DC=PR 


NOS/BE control statement would be the following: 
COMMAND- BATCH,REP0RT9,PRINT 
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/ QU 

Call Query Update. 

QUERY UPDATE 3.4 SYSEDIT-82110 82/05/18 15.37.30 


? VERSION QUCAT OJN=username) 

Attach the permanent file catalog. NOS/BE 
requires an ID parameter instead of a UN 
parameter. 

? RECORDING SESS10 

8egin recording SESS10. 

001 -- 

? INVOKE QUSUB (UN=username) 

002 — 

? EXTRACT UPON FILE10 DESCRIPTION UNIT-PRICE 

Name the subschema. NOS/BE requires an ID 
parameter instead of a UN parameter. 

Extract two fields upon FILE10. 

003 — 

? REWIND FILE10 S0RT10 

004 — 

? SORT FILE10 UPON S0RT10 ON DESCRIPTION 

Rewind FILE10 and the file to be used for 
sorting operations. 

Sort the file on the description field. 

005 — 

? PREPARE REPT10 FROM S0RT10 

Prepare REPT10 from the sorted file. 

006— 

? RECORDING OFF 

END OF SESSION SESS10 

Terminate recording of SESS10. 

? FORMAT REPT10 

Format a report named REPT10. 

? DETAIL IS DESCRIPTION IN COLUMN 1 + 

? UNIT-PRICE IN COLUMN 19 

Supply the report line content. 

? TITLE AT LINE 1 IS JVERTICAL SECTIONS REPORTS + 

? AT LINE 2 IS $ $ 

Supply the report title. 

? PAGE-SIZE IS 2 VERTICAL SECTIONS 

Establish special placement of detail lines 
on a report page. Two sectional divisions 
are to appear across the page. The VERTICAL 
option places successive entries in one 
section and then continues to the second 
section. 

? RECAP AT LINE 2 BEYOND IS + 

? SEND OF VERTICAL SECTIONS REPORTS 

Generate a line of information at the com¬ 
pletion of a report page. A literal expres¬ 
sion is selected to appear two lines after 
the last detail line. 

? PERFORM SESS10 

Retrieve and execute SESS10. 

? END 

Terminate Query Update. 


Figure 6-15. Sample Report Illustrating Report Page Positioning (Sheet 1 of 2) 
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/ route,rept10,dc=pr NOS/BE control statement would be the 

following: COMMAND- BATCH,REPT10,PRINT 


VERTICAL SECTIONS REPORT 


ARM CHAIR 

295.00 

OAK DESK 

1282.50 

BULLETIN BOARD 

15.00 

STOOL 

16.20 

CHALK BOARD 

19.52 

SWIVEL CHAIR 

96.00 

COFFEE TABLE 

95.00 

TABLE LAMP 

39.95 

DESK CHAIR 

149.95 

WALNUT DESK 

1300.00 

DESK LAMP 

19.95 

1-DR FILE CABINET 

45.00 

ELECT TYPEWRITER 

369.00 

3-DR FILE CABINET 

60.00 

FLOOR LAMP 

69.95 

3-SHELF BOOK CASE 

39.95 

LETTER RACK 

3.98 

5-DR FILE CABINET 

90.00 

METAL DESK 

389.95 




END OF VERTICAL SECTIONS REPORT 

** END OF REPORT REPTIO ** 


Figure 6-15. Sample Report Illustrating Report Page Positioning (Sheet 2 of 2) 


COMMAND- ATTACH,PREFILE,ID=QUSER 
COMMAND- FILE,PREFILE,BT=C,RT=Z 
COMMAND- ATTACH,SUMFILE,ID=QUSER 
COMMAND- FILE,SUMFILE,8T=C,RT=Z 

/ ATTACH,PREFILE,SUMFILE 
/ FILE,PREFILE,BT=C,RT=Z 
/ FILE,SUMFILE,BT=C,RT=Z 

/ QU 


QUERY UPDATE 3.4 SYSEDIT-82110 82/05/18 17.16.34 


NOS/BE control statements. The files con¬ 
tain preface and summary information for 
the report. 


NOS control statements. 


Call Query Update. 


? VERSION QUCAT (UN=username) 


? RECORDING SESS11 
001 -- 

? INVOKE QUSUB (UN=username> 


002 — 

? EXTRACT UPON FILE11 DESCRIPTION UNIT-PRICE 
003— 

? SPECIFY SALE-ITEMS AS UNIT-PRICE LT 50 


004— 

? PREPARE REPT11 FROM FILE11 


Attach the permanent file catalog. NOS/BE 
requires an ID parameter instead of a UN 
parameter. 

Begin recording SESS11. 


Name the subschema. NOS/BE requires an ID 
parameter instead of a UN parameter. 


Extract two fields upon FILE11. 


Specify a condition named SALE-ITEMS. The 
condition is a price (UNIT-PRICE) less 
than $50 dollars. 

Prepare REPT11 from the extracted file. 


Figure 6-16. Sample Report Illustrating a Report Preface and Summary (Sheet 1 of 2) 
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005— 

? RECORDING OFF 

END OF SESSION SESS11 


? FORMAT REPT11 

? PREFACE IS TEXT FROM PREFILE 

? SUMMARY IS TEXT FROM SUMFILE 

? SELECT 1 ON SALE-ITEMS 


? DETAIL 1 IS DESCRIPTION IN COLUMN 1 + 
? UNIT-PRICE IN COLUMN 20 


? TITLE AT LINE 1 IS SPREFACE/SUMMARY REPORTS + 
? IN COLUMN 3 AT LINE 2 IS $ $ AT LINE 3 + 

? IS SSALE ITEMSS IN COLUMN 9 + 

? AT LINE 4 IS $ S 


? PERFORM SESS11 

? END 

/ ROUTE,REPT11,CD=PR QU. 

DISTRIBUTE TO ALL OUTLETS BY THE 16TH OF THE MONTH 
PREFACE/SUMMARY REPORT 
SALE ITEMS 


BULLETIN BOARD 

15.00 

CHALK BOARD 

19.52 

1-DR FILE CABINET 

45.00 

LETTER RACK 

3.98 

3-SHELF BOOK CASE 

39.95 

STOOL 

16.20 

DESK LAMP 

19.95 

TABLE LAMP 

39.95 

SALE ENDS ON THE i 

LAST DAY OF 


Terminate recording of SESS11. 


Format a report named REPT11. 

Cause lines of text from permanent file 
PREFILE to precede the current report. 

Cause lines of text from permanent file 
SUMFILE to follow the current report. 

Select the items that satisfy the SALE- 
ITEMS condition. 

Supply the report line content. 


Supply the report title and one column 
heading. 


Retrieve and execute the directives in 
SESS11. 

Terminate Query Update. 

NOS/BE control statement would be the 
following: COMMAND- BATCH,REPT11,PRINT 


** END OF REPORT REPT11 ** 


Figure 6-16. Sample Report Illustrating a Report Preface and Summary (Sheet 2 of 2) 
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PREVIEWING REPORTS 

A two-page sample printout can be produced for any 
report that has an existing directory. A data base 
file requires a directory created with the EXTRACT 
directive; a non-data-base file requires a directory 
created with the DESCRIBE directive. The sample 
report is produced with the PREVIEW directive. 

When the PREVIEW directive is issued with no op¬ 
tions, dummy values of X's and Y's are substituted 


for alphanumeric data and dummy values of 8's and 
9's are substituted for numeric data. When the 
PREVIEW directive is issued with reference to a 
file name, actual data values are used. 


Use of the PREVIEW directive is shown in figure 
6-17. A report entitled PREVIEWED REPORT is pre¬ 
viewed before it is prepared from FILE12. This 
application shows how a report format can be viewed 
and adjusted, if necessary, before preparation. 


/ QU Call Query Update. 

QUERY UPDATE 3.4 SYSEDIT-82110 82/05/19 10.22.37 


? INVOKE QUSUB (UN=username) Issue a sequence of directives that format 

a three-column report. Preview the report 
before issuing the PREPARE directive to 
ensure proper alignment. 

? EXTRACT UPON FILE12 INV-NO + 

? DESCRIPTION UNIT-COST 

19 ACCESSES, 19 HITS, 19 IO-S 


? FORMAT REPT12 


? DETAIL IS INV-NO IN COLUMN 1 + 
? DESCRIPTION IN COLUMN 8 + 

? UNIT-COST IN COLUMN 26 


? TITLE AT LINE 1 IS SPREVIEWED REPORTS + 
? AT LINE 2 IS S $ 


? PREVIEW REPT12 


? 0S,£DIT,REPT12 
PRINT,1 

PREVIEWED REPORT 

XXXXXX YYYYYYYYYYYYYYYYY 9999999 
XXXXXX YYYYYYYYYYYYYYYYY 9999999 
XXXXXX YYYYYYYYYYYYYYYYY 9999999 
XXXXXX YYYYYYYYYYYYYYYYY 9999999 
XXXXXX YYYYYYYYYYYYYYYYY 9999999 
XXXXXX YYYYYYYYYYYYYYYYY 9999999 
XXXXXX YYYYYYYYYYYYYYYYY 9999999 


? END 

** END OF REPORT REPT12 ** 


Generate a sample report with dummy values. 
Display the previewed report. 

X's and Y's represent alphabetic informa¬ 
tion; 9's represent numeric information. 


** CAUTION** 

DEFAULT CATALOG REMAINS AS LOCAL FILE ZZZZZQ2 


Figure 6-17. Previewing a Report 
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THE REPORT UTILITY 

All reports illustrated up to this point are shown 
being prepared by Query Update through the PREPARE 
directive. When a PREPARE directive is encountered. 
Query Update compiles internal tables and uses them 
to produce the report. The tables, which are 
collectively referred to as a report information 
table, serve the following purposes: 

Describe the sequential file that is created as 
a result of an EXTRACT or DESCRIBE directive. 

Associate the sequential file with the report 
layout that is established by the FORMAT direc¬ 
tive . 


Query Update compiles a report information table 
each time a report is prepared and discards the 
table after the report is generated. 

Reports can be prepared for use by the Report 
Utility through the COMPILE directive. When a 
COMPILE directive is used in lieu of the PREPARE 
directive, Query Update compiles the report infor¬ 
mation table and stores it on a local file. When 
the local file is made permanent, reports can be 
subsequently generated by the following steps: 


Attach the permanent file containing the com¬ 
piled report information table. 

Attach the sequential file. 

Define the sequential file characters for CRM. 

Issue a control statement call to the Report 
Utility. 

When a report format is prepared in this manner, 
compilation of the report information table occurs 
only once; a new report information table has to be 
generated only when the report layout is changed. 
This approach results in savings in central proc¬ 
essor time and central memory usage. 

Use of the COMPILE directive is shown in figure 
6-18. A sequential file named COMFILE is generated 
from data base file INVENTORY and the report infor¬ 
mation table is compiled on local file TBLFILE. 
Both files are made permanent for subsequent use by 
the Report Utility. 

Use of the Report Utility is shown in figure 6-19. 
Two sets of control statements are shown. The 
first set uses COMFILE as the input data file; the 
second set uses non-data-base file INDFILE to 
obtain the same results. 


COMMAND- REQUEST,COMFILE,*PF 
COMMAND- REQUEST,TBLFILE,*PF 


NOS/BE control statements. 

/ DEFINE,COMFILE/CT=PU,M=W 
/ DEFINE,TBLFILE/CT=PU,M=W 


NOS control statements. 

COMMAND- QU 


Call Query Update. 

QUERY UPDATE 3.4 SYSEDIT-82110 82/05/19 10.41.32 


INVOKE QUSUB (UN=username) 


Name the subschema. 

EXTRACT UPON COMFILE INV-N0 
19 ACCESSES, 19 HITS, 19 

0N-0RDER 

I0-S 

Extract two fields from COMFILE. 

FORMAT C0MRPT 


Format a report named C0MRPT. 

DETAIL IS INV-N0 IN COLUMN 1 
0N-0RDER IN COLUMN 12 

+ 

Supply the report line content. 

TITLE AT LINE 1 IS SC0MPILED 
AT LINE 2 IS $ $ 

REPORTS 

Supply the report title. 

COMPILE C0MRPT UPON TBLFILE 


Generate the report information table on 
local file TBLFILE. 

PREFACES/SUMMARIES 

(NONE) 


Query Update prints a message that indi¬ 
cates prefaces and summaries are not asso¬ 
ciated with C0MRPT; no additional COMPILE 
directives are needed. 

END 


Terminate Query Update. 


Figure 6-18. Compiling Report Specifications (Sheet 1 of 2) 
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**CAUTION** 

DEFAULT CATAL06 REMAINS AS LOCAL FILE ZZZZZQ2 


COMMAND- 

CATALOG,COMFILE,ID=QUSER,RP=999 

NOS/BE control statements. 

COMMAND- 

CATALOG,TBLFILE,ID=QUSER,RP=999 



Figure 6-18. Compiling Report 

Specifications (Sheet 2 of 2) 

COMMAND- 

ATTACH,COMFILE,ID=QUSER 

ATTACH control statements are issued for sequen- 

COMMAND- 

FILE,COMPILE,RT=F 

tial file COMFILE and report information table 

COMMAND- 

ATTACH,TBLFILE,ID=QUSER 

TBLFILE. A file control statement is issued for 

COMMAND- 

REPORT,R=COMRPT,T-TBLFILE,I-COMFILE 

COMFILE to describe the file for CRM. A REPORT 

COMMAND- 

BATCH,COMRPT,PRINT 

control statement is issued to call the Report 
Utility program to produce the report accordinq 



to specifications in TBLFILE. The R parameter 
names the report; the T parameter names the 



report information table; and the I parameter 
names the input data file. Appropriate com- 



mands direct the finished report to the line 
printer. 

/ ATTACH 

,COMFILE,TBLFILE 


/ FILE,COMFILE,RT=F 


/ REPORT 

,R=COMRPT,T=TBLFILE,I=COMFILE 


/ ROUTE, 

COMRPT,DC=PR 


COMPILED 

REPORT 


AB5972 

9 


AB5973 

0 


AB5975 

3 


BB0013 

8 


CB0168 

0 


CBl 001 

0 


CB1003 

0 


CBl 005 

0 


CH0059 

6 


CH0060 

0 


CH0080 

0 


CM0575 

6 


SH0011 

3 


ST0592 

0 


TY5015 

0 


XN6158 

0 


YB0020 

0 


YB0059 

0 


YB0060 

4 

** END OF REPORT COMRPT ** 


COMMAND- 

ATTACH,INDFILE,ID=QUSER 

The data file can vary from run to run; only its 

COMMAND- 

FILE,INDFILE,RT=F 

characteristics must remain the same. These 

COMMAND- 

REPORT,R=COMRPT,T=TBLFILE,I=INDFILE 

control statements attach INDFILE and use it as 

COMMAND- 

BATCH,COMRPT,PRINT 

input data to the Report Utility. 

/ ATTACH 

rlNDFILE 


/ FILE,INDFILE,RT=F 


/ REPORT 

,R=COMRPT,T=TBLFILE,l=INDFILE 


/ ROUTE,COMRPT,DC=PR 


COMPILED 

REPORT 


A85972 

25 


CB0168 

50 


YB0020 

35 


BB0013 

40 


AB5975 

22 


CH0060 

33 



** END OF REPORT COMRPT ** 



Figure 6-19. Using the Report Utility 
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MULTIPLE FILES AND RELATIONSHIPS 


One Query Update subschema can reference up to 64 
separate data base files. This section of the 
guide shows the declaration of multiple files and 
how they can be individually accessed, and presents 
the relational data base capability in which files 
can be accessed simultaneously. 


DECLARING MULTIPLE FILES 

A subschema named MULTSUB is shown in figure 7-1. 
Unlike subschema QUSUB, which was presented in 
earlier sections, this subschema references multi¬ 
ple files. MULTSUB describes the original INVENTORY 
file along with three additional files named ORDERS, 
LINEITEMS, and OUTLET. 

For ease of illustration, assume that information 
is stored in the new files. Figure 7-2 shows 
sample display operations for the new files and 
introduces the RETURN directive. RETURN allows 
files to be released to the operating system when 
they are no longer needed by Query Update. Return¬ 
ing a file frees a portion of central memory. 

If the returned file is a data base area, its 
internal tables are released; the file itself is 
not released to the operating system. If the file 
is a non-data-base file, a RETURN releases the file 
to the operating system. There is no need to 
release a data base area specified through an INVOKE 
directive, which is not a temporary area, because 
INVOKE does not attach the file; directives that 
reference the area (such as DISPLAY) attach the 
file, reference it, and release it. 

Two RETURN directives will release to the operating 
system a TEMPORARY area or an area specified through 
a CREATE directive. The first RETURN releases 
internal tables; the second performs a RETURN on a 
non-data-base file and releases it to the operating 
system. 

The LINEITEMS file lends itself to .arithmetic 
operations. Figure 7-3 is a sample report that 
illustrates subtotaling facilities. Two directives 
are introduced: MOVE and FOOTING. 


MODIFYING MULTIPLE FILES 

When modifying files that are data base areas in a 
multiple file subschema, the UPDATE directive tells 
Query Update which file i6 to be modified. The 
UPDATE directive is shown in figure 7-4. 


IDENTIFICATION DIVISION. 

SUB-SCHEMA NAME IS MULTSUB 
DATA DIVISION. 

AREA-NAME IN INVENTORY M IS W 
INDEX IS INVIDX M IS W 
ORGANIZATION IS INOEXED NEW 
KEY IS INV-NO 

KEY IS ALTERNATE BACK-ORDER DUPLICATES INDEXED 
RECORD-NAME IS INV-REC 

02 INV-NO PIC X(6) 

02 IN-STOCK PIC Z<3>9 

02 BACK-ORDER PIC Z(3)9 

02 ON-ORDER PIC Z(3)9 

02 REORDER-PT PIC Z(3>9 

02 UNIT-COST PIC Z(4).99 

02 UNIT-PRICE PIC Z(4).99 

02 DESCRIPTION PIC XC17) 

AREA-NAME IS ORDERS M IS W 
INDEX IS 0RDIDX M IS W 
ORGANIZATION IS INDEXED NEW 
KEY IS ORDER-NO 

KEY IS ALTERNATE OUTLET-CODE DUPLICATES INDEXED 
RECORD-NAME IS 0RDER-REC 

02 ORDER-NO PIC 9(6) 

02 ORDER-DATE PIC XC10) 

02 TOT-ORDER PIC Z(6).99 

02 OUTLET-CODE PIC X(4) 

AREA-NAME IS LINEITEMS M IS W 
INDEX IS ITMIDX M IS W 
ORGANIZATION IS ACTUAL NEW 
KEY IS ACT-KEY 

KEY IS ALTERNATE 0RDER-N0 DUPLICATES INDEXED 
KEY IS ALTERNATE INV-NO DUPLICATES INDEXED 
RECORD-NAME IS ITEM-REC 

02 ACT-KEY PIC 9(5) USAGE IS INTEGER 

02 ORDER-NO PIC 9(6) 

02 INV-NO PIC X(6) 

02 QUANTITY PIC Z(4)9 

02 ITEM-PRICE PIC Z(4).99 

02 OUTLET-CODE PIC X(4) 

AREA-NAME IS OUTLET M IS W 
ORGANIZATION IS DIRECT NEW 
KEY IS OUTLET-CODE 
RECORD-NAME IS 0UTLET-REC 

02 OUTLET-CODE PIC X(4) 

02 OUTLET-ADDR 

05 OUTLET-STREET PIC X(16) 

05 OUTLET-CITY PIC X(16) 

05 OUTLET-STATE PIC A(2) 

05 OUTLET-ZIP PIC 9(5) 


Figure 7-1. A Multiple File Subschema 
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/ QU 


Call Query Update 


QUERY UPDATE 3.4 SYSEDIT-82110 81/06/22 10.06.52 


? INVOKE MULTSUB (UN=username) 


? DISPLAY ORDER-NO OF ORDER-REC + 
? ORDER-DATE TOT-ORDER + 

? OUTLET-CODE OF ORDER-REC + 
430001 07/01/81 2374.45 AZ43 

440001 07/02/81 8647.20 NV44 

460001 07/03/81 754.00 CA46 

3 ACCESSES, 3 HITS, 3 IO-S 


? RETURN ORDERS 


? DISPLAY ORDER-NO OF ITEM-REC + 

? INV-NO OF ITEM-REC QUANTITY + 

? ITEM-PRICE OUTLET-CODE OF ITEM-REC 


430001 

A85972 

3 

389.95 

AZ43 

430001 

TY5015 

3 

369.00 

AZ43 

430001 

CB0168 

5 

19.52 

AZ43 

440001 

AB5975 

3 

1300.00 

NV44 

440001 

CH0060 

6 

149.95 

NV44 

440001 

AB5973 

3 

1282.50 

NV44 

460001 

CB1003 

7 

60.00 

CA46 

460001 

BB0013 

9 

15.00 

CA46 

460001 

CM0575 

50 

3.98 

CA46 


9 ACCESSES 

, 9 

HITS, 9 

IO-S 


? RETURN LINEITEMS 


? DISPLAY OUTLET-CODE OF OUTLET-REC + 

? OUTLET-STREET OUTLET-CITY + 

? OUTLET-STATE OUTLET-ZIP 
AZ43 3440 N CENTRAL PHOENIX AZ 85015 

CA46 1000 U MAIN SAN FRANCISCO CA 94111 

NV44 1231 E SAHARA LAS VEGAS NV 89105 

3 ACCESSES, 3 HITS, 3 IO-S 


? EXTRACT UPON FILE1 OUTLET-STREET 
3 ACCESSES, 3 HITS, 3 IO-S 


? RETURN FILE1 


Name the subschema. NOS/BE requires an 
ID parameter instead of a UN parameter. 

Attach ORDERS and ORDIDX, display all 
fields of ORDERS, and release ORDERS and 
ORDIDX to the operating system. 


Release the internal tables of file 
ORDERS. 

Attach LINEITEMS and ITMIDX, display 
all LINEITEMS, and release LINEITEMS 
and ITMIDX to the operating system. 


Release the internal tables of file 
LINEITEMS. 

Attach OUTLET, display all fields of 
OUTLET, and release OUTLET to the 
operating system. 


Build a one-field subset of OUTLET and 
an associated directory. 


Release the internal tables associated 
with file FILE1 and release FILE1 to the 
operating system. 


Figure 7-2. Querying Multiple Files 
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/ QU 


Call Query Update 


QUERY UPDATE 3.4 SYSEDIT-82110 81/06/23 14.16.12 


? VERSION QUCAT (UN=username) 


? RECORDING MSESS 
001 — 

? INVOKE MULTSUB (UN=username) 

002 — 

? EXTRACT UPON MFILE ORDER-NO OF ITEM-REC AS 0 + 
? INV-NO OF ITEM-REC AS I QUANTITY AS Q + 

? ITEM-PRICE AS P OUTLET-CODE OF ITEM-REC AS C 

003— 

? REWIND MFILE MSORT 
004— 

? SORT MFILE UPON MSORT ON 0 

005— 

? DEFINE TOTAL BY $Z(5).99$ = Q * P 


006— 

? DEFINE SUBTOTAL BY $Z(6).99$ 
007— 

? DEFINE GRANDTOTAL BY $Z(7).99$ 
008— 

? PREPARE MRPT FROM MSORT 

009— 

? RECORDING OFF 
END OF SESSION MSESS 


? FORMAT MRPT 


? EVALUATE BEFORE ANY DETAIL TOTAL 


? TITLE AT LINE 1 IS SSUBTOTAL REPORTS IN COLUMN 16 


? DETAIL IS 0 IN COLUMN 1 I IN COLUMN 9 + 
? Q IN COLUMN 15 P IN COLUMN 24 + 

? TOTAL IN COLUMN 33 C IN COLUMN 43 


? BREAK 1 ON ITEM 0 


? HEADING 0 AT LINE 4 BEYOND IS SORDERS IN COLUMN 1 + 
? IS SITEMS IN COLUMN 10 IS SQTYS IN COLUMN 18 + 

? IS SPRICES IN COLUMN 25 IS STOTALS IN COLUMN 35 + 

? IS SCOPES IN COLUMN 43 AT LINE 5 BEYOND IS S $ 


Attach the permanent catalog. 


Begin recording session MSESS. 


Name the subschema. NOS/BE requires an 
ID parameter instead of a UN parameter. 

Extract 5 fields upon MFILE. The AS 
option renames each field. 


Rewind MFILE and the file to be used 
for sorting operations. 

Sort the file on the ON-ORDER field, 
renamed 0. 

Define a temporary item named TOTAL 
whose value is evaluated by Query 
Update. 

Define a temporary item named SUBTOTAL. 


Define a temporary item named 
GRANDTOTAL. 

Prepare MRPT from the sorted file. 


Terminate recording of MSESS. Query 
Update acknowledges the end of the 
session. 

Format a report named MRPT. 


Evaluate temporary item TOTAL before 
the DETAIL production step. 

Supply the report title. 


Supply the report line content. The 
new field names must be used. 


Break when the content of field 0 (the 
renamed ORDER-NO field) changes. 

Specify the heading that is to appear 
before any input data is processed. 


Figure 7-3. Sample Report Illustrating Subtotaling Operations (Sheet 1 of 2) 
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? FOOTING 0 AT LINE 2 BEYOND IS + 

? SGRAND TOTAL $ GRANDTOTAL IN COLUMN 19 


? FOOTING 1 AT LINE 2 BEYOND IS + 

? SSUBTOTAL $ SUBTOTAL IN COLUMN 23 AT LINE 3 BEYOND IS 


? MOVE BEFORE ANY DETAIL SUBTOTAL + TOTAL TO SUBTOTAL + 
? AND GRANDTOTAL + TOTAL TO GRANDTOTAL 


? MOVE AFTER FOOTING 1 0 TO SUBTOTAL 


? PERFORM MSESS 


The FOOTING directive shows the content 
and positioning of a footing. Level 0 
indicates that this footing is asso¬ 
ciated with the end of data. 

FOOTING 1 is associated with BREAK 1. 

$ $ This footing will appear when the 

content of field 0 (the renamed 
ORDER-NO field) changes. 

The MOVE directive moves values to 
data names. Values are moved before 
the DETAIL production step. 

Set the content of SUBTOTAL to zero 
after a level 1 footing is executed. 


? END 

/ ROUTE,MRPT,DC=PR 


SUBTOTAL REPORT 


Terminate Query Update. 

Print the report. Under NOS/BE 
the control statement would be 
COMMAND- BATCH,MRPT,PRINT 


ORDER 

ITEM 

QTY 

PRICE 

TOTAL 

CODE 

430001 

AB5972 

3 

389.95 

1169.85 

AZ43 

430001 

TY5015 

3 

369.00 

1107.00 

AZ43 

430001 

CB0168 

5 

19.52 

97.60 

AZ43 




SUBTOTAL 

2374.45 


440001 

AB5975 

3 

1300.00 

3900.00 

NV44 

440001 

CH0060 

6 

149.95 

899.70 

NV44 

440001 

AB5973 

3 

1282.50 

3847.50 

NV44 




SUBTOTAL 

8647.20 


460001 

CB1003 

7 

60.00 

420.00 

CA46 

460001 

BB0013 

9 

15.00 

135.00 

CA46 

460001 

CM0575 

50 

3.98 

199.00 

CA46 




SUBTOTAL 

754.00 



GRAND TOTAL 11775.65 

** END OF REPORT MRPT ** 


Figure 7-3. Sample Report Illustrating Subtotaling Operations (Sheet 2 of 2) 
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/ QU 


Call Query Update. 


QUERY UPDATE 3.4 SYSEDIT-82110 


81/06/24 09.23.10 


? INVOKE MULTSUB (UN=username) 


Name the subschema. NOS/BE requires an 
ID parameter instead of a UN parameter. 


? UPDATE OUTLET 


Name the file. 


? MODIFY USING OUTLET-CODE SETTING OUTLET-STREET + 
? OUTLET-ZIP 

» SCA46S $210 E MARKETS 94115 
» *END 

1 ACCESSES, 1 HITS, 2 IO-S 


Modify two fields. 


Terminate the MODIFY directive. 


? DISPLAY KEY SCA46$ OUTLET-STREET OUTLET-ZIP 
210 E MARKET 94115 

1 ACCESSES, 1 HITS, 1 IO-S 


Verify that outlet CA46 has a new 
address. 


? UPDATE ORDERS 


Name another file. 


? STORE SETTING ORDER-NO ORDER-DATE + 
? TOT-ORDER OUTLET-CODE 
» 450001 $07/08/81* 398.95 SWA45S 
» *END 

1 ACCESSES, 1 HITS, 1 IO-S 


Store a new record. 


Terminate the STORE directive. 


Terminate Query Update. 


Figure 7-4. Modifying Multiple Files 
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ESTABLISHING RELATIONSHIPS 

| The multiple file subschema MULTSUB presented in 
the preceding paragraphs described several files. 
Each file could be accessed for query, update, or 
report operations — but data could be retrieved 
from only one file at a time. 

Inherent relationships exist among INVENTORY, 
ORDERS, LINEITEMS, and OUTLET. Some data items 
appear in more than one file. For example, data 


item INV-NO appears in INVENTORY and LINEITEMS, and 
data item OUTLET-CODE appears in ORDERS, LINEITEMS, 
and OUTLET. A logical connection can be estab¬ 
lished within the subschema to allow two or more 
files to be queried as one file. 


A relational subschema is shown in figure 7-5. 
MULTSUB, renamed RELSUB, is expanded to include a 
Relation Division that specifies two relations! 
CONTEST and ACTIVITY-CHECK. 


IDENTIFICATION DIVISION. 

SUB-SCHEMA NAME IS RELSUB 
DATA DIVISION. 

AREA-NAME IS INVENTORY M IS W 
INDEX IS INVIDX M IS W 
ORGANIZATION IS INDEXED NEW 
KEY IS INV-NO 

KEY IS ALTERNATE BACK-ORDER DUPLICATES INDEXED 
RECORD-NAME IS INV-REC 
02 INV-NO 
02 IN-STOCK 
02 BACK-ORDER 


02 ON-ORDER 
02 REORDER-PT 
02 UNIT-COST 
02 UNIT-PRICE 
02 DESCRIPTION 
AREA-NAME IS ORDERS M 


PIC X(6) 

PIC Z(3)9 
PIC Z(3)9 
PIC Z(3)9 
PIC Z(3)9 
PIC Z(4).99 
PIC Z(4).99 
PIC X(17) 

IS W 


INDEX IS 0RDIDX M IS W 
ORGANIZATION IS INDEXED NEW 
KEY IS ORDER-NO 

KEY IS ALTERNATE OUTLET-CODE DUPLICATES INDEXED 
RECORD-NAME IS 0RDER-REC 

02 0RDER-N0 PIC 9(6) 

02 ORDER-DATE PIC X(10) 

02 TOT-ORDER PIC Z(6).99 

02 OUTLET-CODE PIC X(4) 

AREA-NAME IS LINEITEMS M IS W 
INDEX IS ITMIDX M IS W 
ORGANIZATION IS ACTUAL NEW 
KEY IS ACT-KEY 

KEY IS ALTERNATE ORDER-NO DUPLICATES INDEXED 
KEY IS ALTERNATE INV-NO DUPLICATES INDEXED 
RECORD-NAME IS ITEM-REC 

02 ACT-KEY PIC 9(5) USAGE IS INTEGER 

02 ORDER-NO PIC 9(6) 

02 INV-NO PIC X(6) 

02 QUANTITY PIC Z(4)9 

02 ITEM-PRICE PIC Z(4).99 

02 OUTLET-CODE PIC X(4) 

AREA-NAME IS OUTLET M IS W 
ORGANIZATION IS DIRECT NEW 
KEY IS OUTLET-CODE 
RECORD-NAME IS OUTLET-REC 

02 OUTLET-CODE PIC X(4) 

02 OUTLET-ADDR 

05 OUTLET-STREET PIC X(16) 

05 OUTLET-CITY PIC X(16) 

05 OUTLET-STATE PIC A(2) 

05 OUTLET-ZIP PIC 9(5) 

RELATION DIVISION. 

RELATION-NAME IS CONTEST 

JOIN WHERE OUTLET-CODE OF ORDER-REC EQ OUTLET-CODE OF OUTLET-REC 

RESTRICT ORDER-REC WHERE TOT-ORDER GE 5000 

RELATION-NAME IS ACTIVITY-CHECK 

JOIN WHERE INV-NO OF INV-REC EQ INV-NO OF ITEM-REC 

OUTLET-CODE OF ITEM-REC EQ OUTLET-CODE OF OUTLET-REC 

RESTRICT OUTLET-REC WHERE OUTLET-CITY EQ "PHOENIX" 


Figure 7-5. A Relational Subschema 
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The CONTEST relation joins the ORDERS and OUTLET 
areas. Data from both files can be returned when¬ 
ever these two files are traversed by Query Update. 
The files are traversed when at least one data item 
in each file is referenced in a Query Update trans¬ 
mission. The CONTEST relation Imposes one restric¬ 
tion on the ORDERS file. Data is returned only 
when the TOT-ORDER field contains a value greater 
than or equal to 5000. 

The ACTIVITY-CHECK relation joins the INVENTORY, 
LINEITEMS, and OUTLET areas. Data can be returned 
from these files whenever they are traversed by 
Query Update. The ACTIVITY-CHECK relation imposes 
one restriction on the OUTLET file. Data is re¬ 
turned only when the OUTLET-CITY field contains the 
value PHOENIX. 

The relationships are shown in the diagram in fig¬ 
ure 7-6. The solid arrow traces CONTEST. The 
shaded arrows trace ACTIVITY-CHECK. 


QUERYING RELATED FILES 

Related files are queried in the same manner as 
individual files. When queries are issued against 
files joined in a relation, Query Update searches 
the joined files and returns the qualifying data as 
one projected record. Query Update determines 
which relation to use by the data names specified 
in a directive. 


Interactive query begins with the INVOKE directive, 
which makes all areas and relations described in 
the subschema available. Sample queries involving 
relations are shown in figure 7-7. 


RECONCILING AMBIGUITIES 

Ambiguities can exist if the same files are joined 
in different relations and the data items named in 
the query are from these files only. The VIA 
directive specifies the relation that should be 
followed when such ambiguities exist. The direc¬ 
tive can be entered alone as a single transmission 
or included in a query transmission. The VIA 
directive is illustrated in figure 7-8. 


MODIFYING RELATED FILES 

Relations are limited to read-only operations. 
When files joined in a relationship are to be modi¬ 
fied, the modification is made on each individual 
file, one at a time. 

Care should be taken when joined files are modified. 
If, for example, an inventory number (INV-NO) in 
the INVENTORY file is changed, appropriate changes 
must be reflected in the LINEITEMS file to maintain 
the integrity of projected records. 



Figure 7-6. The Relationships Between Areas 
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/ QU 


Call Query Update 


QUERY UPDATE 3.4 SYSED1T-82110 81/06/26 13.30.26 


? INVOKE RELSUB (UN=usernaae) 


? DISPLAY TOT-ORDER OUTLET-CITY 


8647.20 LAS VE6AS 

1 ACCESSES, 1 HITS, 4 IO-S 


? DISPLAY $THE ORDER THAT WAS EQUAL TO + 

? OR 6REATER THAN SS5000 WASS TOT-ORDER + 

? $*****THE WINNER ISS OUTLET-CITY 

THE ORDER THAT WAS EQUAL TO OR GREATER THAN S5000 WAS 
***** THE WINNER IS LAS VEGAS 

1 ACCESSES, 1 HITS, 4 IO-S 


? DISPLAY DESCRIPTION QUANTITY OUTLET-CITY 
METAL DESK 3 PHOENIX 

CHALK BOARD 5 PHOENIX 

ELECT TYPEWRITER 3 PHOENIX 

19 ACCESSES, 3 HITS, 35 IO-S 


? DISPLAY DESCRPTION INV-NO OF ITEM-REC + 
? OUTLET-CITY 

METAL DESK A85972 PHOENIX 

CHALK BOARD CB0168 PHOENIX 

ELECT TYPEWRITER TY5015 PHOENIX 

19 ACCESSES, 3 HITS, 35 IO-S 


? EXTRACT UPON RELFILE DESCRIPTION QUANTITY + 
? ITEM-PRICE OUTLET-CITY 

19 ACCESSES, 3 HITS, 35 IO-S 


? FORMAT RELRPT 


? TITLE AT LINE 1 IS + 

? SPHOENIX ACTIVITY REPORTS IN COLUMN 11 + 
? AT LINE 2 IS S $ 


? DETAIL IS DESCRIPTION IN COLUMN 1 + 
? QUANTITY IN COLUMN 20 + 

? ITEM-PRICE IN COLUMN 26 + 

? OUTLET-CITY IN COLUMN 35 


? PREPARE RELRPT FROM RELFILE 


? END 


Name the subschema. NOS/BE 
requires an ID parameter instead 
of a UN parameter. 

Display across the ORDERS and 
OUTLET files. Query Update auto¬ 
matically ses the CONTEST relation. 

Query Update imposes the restric¬ 
tion on TOT-ORDER. 


Clarify the display with literals. 


8647.20 


Display across the INVENTORY, 
LINEITEMS, and OUTLET files. Query 
Update automatically uses the 
ACTIVITY-CHECK relation. Query 
Update imposes the restriction on 
OUTLET-CITY. 

This display references INV-NO, 
which is not unique. The data 
item must be qualified. 


Prepare a report using the 
ACTIVITY-CHECK relation. The 
report is concerned only with the 
Phoenix outlet only because of the 
restriction on OUTLET-CITY. 


Terminate Query Update. 


Figure 7-7. Querying a Relation (Sheet 1 of 2) 
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♦♦CAUTION** 

DEFAULT CATALOG REMAINS AS LOCAL FILE ZZZZZQ2 


/ ROUTE,RELRPT,DC-PR Print the report. Under NOS/BE the 

control statement would be COMMAND- 
BATCH, RELRPT, PRINT. 


PHOENIX ACTIVITY REPORT 

METAL DESK 3 389.95 PHOENIX 

CHALK BOARD 5 19.52 PHOENIX 

ELECT TYPEWRITER 3 369.00 PHOENIX 

** END OF REPORT RELRPT ** 

Figure 7-7. Querying a Relation (Sheet 2 of 2) 

? INVOKE RELSUB (UN=username) 

? VIA ACTIVITY-CHECK 

? DISPLAY ... 

? VIA ACTIVITY-CHECK DISPLAY ... 

? DISPLAY ... VIA ACTIVITY-CHECK 


Figure 7-8. The VIA Directive 


VIA can be a separate transmission. 

Where the ellipses indicate data names from 
areas INVENTORY and LINE ITEMS, which are 
joined in relation ACTIVITY-CHECK. 

VIA can precede a query. 

VIA can follow a query. 
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SPECIAL UTILITIES 
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A number of special Query Update utilities are 
available to assist programmers by providing access 
to and clarification of stored information and 
offering subscripting capabilities. 

Query Update uses a large amount of stored reference 
information within its processing environment. 
Typical information includes subschema descriptions 
and permanent catalog contents. This type of 
information is made available to the programmer 
through several informative directives. 

Subscripting operations can be performed within 
Query Update. Elements within an array or repeat¬ 
ing group can be accessed by supplying an integer, 
data name, or figurative subscript. 


INFORMATIVE DIRECTIVES 

Query Update includes the following four directives 
that supply information that can be helpful to the 
new user: 

DIAGNOSTIC 

Expands diagnostic messages to aid in de¬ 
bugging 

EXHIBIT 

Displays current information related to 
permanent and temporary data names, rela¬ 
tions, reports, and sessions 


HELP 

Provides descriptions of directives and 
explains diagnostic messages 

NOTE 

Allows comments to be included in trans¬ 
missions 

These directives can be issued at any time without 
affecting the operation in progress. Each is 
described in the following paragraphs. 

DIAGNOSTIC 

Query Update analyzes the syntax of a directive 
after it is transmitted. When errors appear in the 
input string. Query Update prints a three-digit 
number followed by a diagnostic message. Full or 
partial diagnostics can be displayed. When diag¬ 
nostics are full, Query Update displays all diag¬ 
nostic messages. When diagnostics are partial 
(default), Query Update does not display consecu¬ 
tive duplicate messages but indicates instead the 
number of times the diagnostic occurred. 

Use of the DIAGNOSTIC directive with both the FULL 
and PART options is shown in figure 8-1. In both 
cases, the INVOKE directive includes an invalid 
character. When the FULL option is in effect, 
message number 007 is repeated. When the PART 
option is in effect, consecutive appearances of 
message number 007 are not repeated. 


/ QU 

QUERY UPDATE 3.4 SYSEDIT-82110 81/06/24 13.40.25 

? DIAGNOSTIC FULL 

? INV0K> QUSU> 

(007) INVALID CHARACTER IN A NAME OR KEYWORD INV0K> 

(007) INVALID CHARACTER IN A NAME OR KEYWORD QUSU> 

(077) INV0K> INVALID QU DIRECTIVE 


? DIAGNOSTIC PART 


? INV0K> QUSU> 

(007) INVALID CHARACTER IN A NAME OR KEYWORD INV0K> 
THERE WERE 001 MORE 007 DIAGNOSTIC(S). 

(077) INV0K> INVALID QU DIRECTIVE 


Figure 8-1. The DIAGNOSTIC Directive 


60499000 C 


8-1 • 


EXHIBIT 

Query Update deals with large amounts of informa¬ 
tion. Any number of subschemas can be stored in 
the system, and each subschema can reference up to 
64 files. Any number of permanent file catalogs 
can also be stored in the system, and no limitation 
is imposed on the number of recorded sessions and 


•? INVOKE RELSUB (UN=username> 


? EXHIBIT 

MAXIMUM TRANSMISSION LENGTH 1030 
TL OF CATALOG FILE 1030 
SEPARATOR $ 

UNIVERSAL OFF 
MAX NUMBER OF LINES 060 
MAX NUM. OF COLUMNS 136 
MAX NO. OF SECTIONS 010 
MAX IMAGES PER PAGE 004 
AREA NAME(S): 

INVENTORY 

ORDERS 

LINEITEMS 

OUTLET 

SUBSCHEMA NAME = RELSUB 
SUBSCHEMA LIBRARY NAME = RELSUB 
UN = username 


? EXHIBIT RELATION 
CONTEST RELATES THE RECORDS: 
0RDER-REC IN ORDERS 
OUTLET-REC IN OUTLET 
ACTIVITY-CHECK RELATES THE RECORDS: 
INV-REC IN INVENTORY 
ITEM-REC IN LINEITEMS 
OUTLET-REC IN OUTLET 


? EXHIBIT INVENTORY 
RECORD NAME IS INV-REC 
KEY IS INV-N0 
ALT KEY BACK-ORDER 
AREA PF NAME = INVENTORY 
UN 3 username 
INDEX PF NAME = INVIDX 
M = W 


? EXHIBIT DESCRIPTION 
DESCRIPTION OF INV-REC 
TYPE CHAR ITEM PIC SIZE 0017 


? VERSION QUCAT CUN=username> 


? EXHIBIT REPORTS REP0RT7 TITLE 

TITLE AT LINE 1 IS STEMPORARY ITEM 
REPORTS IN COLUMN 6 AT LINE 2 IS $ S AT 
LINE 3 IS SITEMS IN TAB 1 IS SPROFIT MARGINS 
IN TAB 2 AT LINE 4 IS S S 


? EXHIBIT SESSIONS SESS8 001 TO 003 

1 INVOKE QSUB (UN-username) 

2 EXTRACT UPON FILE8 DESCRIPTION INV-NO IN-STOCK 

3 UNIVERSAL IS * 


report formats that can be retained. All informa¬ 
tion referenced by and contained within these files 
can be made available through the EXHIBIT directive. 

Use of the EXHIBIT directive is shown in figure 8-2. 
Selected information concerning the subschema and 
the QUCAT catalog is displayed. 


Name the subschema. NOS/BE requires an 10 
parameter instead of a UN parameter. 

Exhibit subschema information. 


Exhibit relation information. 


Exhibit information for area INVENTORY. 


Exhibit information for elementary item 
DESCRIPTION. 


Attach the permanent catalog. NOS/BE 
requires an ID parameter instead of a UN 
parameter. 


Exhibit the TITLE directive for report 
REP0RT7. 


Exhibit transmission IDs 001 through 003 
for session SESS8. 


Figure 8-2. The EXHIBIT Directive 


• 8-2 
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HELP 


Use of the HELP directive is shown in figure 8-3. 
Selected information concerning directives and 
diagnostics is displayed. 


Query Update provides over 60 directives and issues 
over 500 diagnostic messages. Definitions of the 
directives and detailed explanations of the diag¬ 
nostic messages can he made available through the 
HELP directive. 


? HELP PREFACE Ask for the definition of the PREFACE 

directive. 

PREFACE CAUSES LINES OF TEXT OR ANOTHER REPORT TO 
PRECEDE THE CURRENT REPORT. 


? HELP SELLECT 

(212) -SELLECT- IS NOT VALID FOLLOWING HELP. 

(029) ERRONEOUS DIRECTIVE AND REST OF TRANSMISSION IGNORED 


? HELP 212 Ask for a more detailed explanation 

of diagnostic message 212. 

THE ONLY VALID HELP PARAMETERS ARE EITHER A DIRECTIVE NAME 
OR A DIAGNOSTIC NUMBER. 


Ask for the definition of the SELECT 
directive and misspell its name. 


? HELP SELECT Ask for the definition of the SELECT 

directive. 

SELECT STATES CRITERIA FOR SELECTION OF DETAIL 
SPECIFICATIONS. 


? HELP 


DIRECTIVES 

IMPLEMENTED IN THIS 

RELEASE ARE 

ACCESS 

ALTER 

BREAK 

COMPILE 

CREATE 


DATE 

DEFINE 

DELETE 

DESCRIBE 

DETAIL 

DIAG 

DISPLAY 

DUPLICATE 

END 

ERASE 

EVALUATE 


EXECUTE 

EXHIBIT 

EXTRACT 

FOOTING 

FORMAT 

HEADING 

HELP 

INVOKE 

IF 

INSERT 

MODIFY 

MOVE 

NOTE 

OS 

PAGE-NUMBER 


PAGE-SIZE 

PERFORM 

PREFACE 

PREPARE 

PRINT 

PREVIEW 

RECAP 

RECORDING 

RECOVERY 

REMOVE 

RETURN 

REWIND 

SELECT 

SEPARATOR 

SORT 

SPECIFY 

STOP 

TABS 

STORE 

SUMMARY 

TIME 

TITLE 

UNIVERSAL 

UPDATE 

USE 

VERIFY 

VERSION 

WRITE 

VETO 

VIA 


Ask for a list of available 
directives. 


Figure 8-3. The HELP Directive 
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NOTE 

Notes and comments can be useful, particularly when 
recorded sessions and report formats must be main¬ 
tained by someone other than the originator. Notes 
can be incorporated through the NOTE directive as 
complete transmissions or can be appended as the 


last portion of a transmission containing other 
directives. All characters between keyword NOTE and 
the end of transmission are accepted as comments. 

Use of the NOTE directive is shown in figure 8-4. 
Two notes are recorded and exhibited. 


? VERSION QUCAT (UN=userna»e) 


? RECORDING SESS13 
001 -- 

? INVOKE QUSUB (UN=username) 

002 — 

? NOTE THIS REPORT EXTRACTS DATA FROM ONE FIELD 


003— 

? EXTRACT UPON FILE13 DESCRIPTION NOTE THIS IS + 
? A 17-CHARACTER ALPHANUMERIC FIELD 

004— 

? PREPARE REPT13 FROM FILE13 


NOS/BE requires an ID 
parameter instead of a UN 
parameter. 


Insert a note as a com¬ 
plete transmission. 

Append a note to a trans¬ 
mission. 


005— 

? RECORDING OFF 

END OF SESSION SESS13 


? FORMAT RPT13 


? DETAIL IS DESCRIPTION IN COLUMN 1 


? EXHIBIT SESSION SESS13 Notes are printed through 

1 INVOKE QUSUB (UN=username) the EXHIBIT directive. 

2 NOTE THIS REPORT EXTRACTS DATA FROM ONE FIELD 

3 EXTRACT UPON FILE13 DESCRIPTION NOTE THIS IS A 17-CHARACTER A 
LPHANUMERIC FIELD 

4 PREPARE REPT13 FROM FILE13 


Figure 8-4. The NOTE Directive 
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SUBSCRIPTING 

Subscripting operations can be performed when a 
series of data items is referenced by one data 
name. The data items can be represented as repeat¬ 
ing group or elementary data items in the subschema, 
or as an array entered through the DEFINE directive. 
The subscript can be an integer, the data name of 
an item containing an integer, or one of four 
figurative subscripts: ALL, LAST, NEXT, or ANY. 
Figurative subscript ANY is restricted to the IF, 
BREAK, SELECT, SPECIFY, and PERFORM UNTIL direc¬ 
tives. Figurative subscript NEXT is restricted to 
the MOVE and STORE SETTING directives. 


An application illustrating the subscripting capa¬ 
bility is shown in figure 8-5. The subschema 
contains a repeating elementary item named CHILD. 
The CHILD matrix is constructed by including figu¬ 
rative subscript NEXT in the STORE SETTING directive 
that creates the sample data base. The display 
operations that follow illustrate subscripts speci¬ 
fied as integers and as figurative constants ALL 
and LAST. 


IDENTIFICATION DIVISION. 
SUB-SCHEMA NAME IS PERS 
DATA DIVISION. 

AREA-NAME IS PERSONNEL M IS W 
ORGANIZATION IS INDEXED NEW 
KEY IS SSN 

RECORD-NAME IS PERSRECORD 


02 

SSN 

PIC X(9) 


02 

EMPNAME 

PIC X(20) 


02 

KIDSNO 

PIC 9 


02 

CHILD 

PIC X(10) 
DEPENDING 

OCCURS 0 TO 9 TIMES 
ON KIDSNO 


/ QU 

QUERY UPDATE 3.4 SYSEDIT-82110 04/25/82 14.43.02 


? CREATE PERSONNEL OF PERS (UN=username) 


? STORE SETTING SSN EMPNAME CHILD(NEXT) CHILD(NEXT) CHILD (NEXT) 
» $111223333$ $J0HN R. DOES SJEFFS SLARRYS SCEDRICS 
» $222334444$ $JACK C. JONESS 
» $333445555$ $GIL F. GULLES$ $ALIC£$ SERICAS 
» $444556666$ $ABE A. ABBOTTS SJONASS 
» *END 

4 ACCESSES, 4 HITS, 4 I0-S 


? DISPLAY KIDSNO CHILD(ALL) 


3 JEFF 

LARRY 

CEDRIC 

0 



2 ALICE 

ERICA 


1 JONAS 




4 ACCESSES, 4 HITS, 4 IO-S 


? IF KIDSNO GE 1 DISPLAY SSN KIDSNO CHILD(LAST) 
111223333 3 CEDRIC 
333445555 2 ERICA 
444556666 1 JONAS 

4 ACCESSES, 3 HITS, 4 IO-S 


Figure 8-5. Subscripting (Sheet 1 of 2) 


60499000 C 


8-5 • 


? DISPLAY CHILD(1) CHILD(2) CHILD(3) 
JEFF LARRY CEDRIC 

(941) SUBSCRIPT OUT OF BOUNDS 
THERE WERE 002 MORE 941 DIAGNOSTIC(S). 
4 ACCESSES, 4 HITS, 4 IO-S 


? DISPLAY PERSRECORD NOTE - THIS IS TO SEE THE COMPLETE RECORD 
(209) REQUESTED DATA NAY NOT BE IN DISPLAY FORMAT 


111223333J0HN R. DOE 

3JEFF 

LARRY 

CEDRIC 

222334444JACK C. JONES 

0 



3334455556IL F. GULLES 

2ALICE 

ERICA 


444556666ABE A. ABBOTT 

1 JONAS 



4 ACCESSES, 4 HITS, 

4 IO-S 




? END 


Figure 8-5. Subscripting (Sheet 2 of 2) 
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STANDARD CHARACTER SETS 


A 


Control Data operating systems offer the following 
variations of a basic character set: 

CDC 64-character set 

CDC 63-character set 

ASCII 64-character set 

ASCII 63-character set 


The set in use at a particular installation was 
specified when the operating system was installed. 

Graphic character representation appearing at a 
terminal or printer depends on the installation 
character set and the terminal type. Characters 
shown in the CDC Graphic column of the standard 
character set table (table A-l) are applicable to 
BCD terminals; ASCII graphic characters are appli¬ 
cable to ASCII-CRT and ASCII-TTY terminals. 

Standard collating sequences for the two printer 
character sets are shown in tables A-2 and A-3. 
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TABLE A-l. STANDARD CHARACTER SETS 



CDC 1 

ASCII 1 

Display 

Code 

(octal) 

Graphic 

Hollerith 

Punch 

(026) 

External 

BCD 

Code 

Graphic 

Subset 

Punch 

(029) 

Code 

(octal) 

00* 

: (colon)** 

82 

00 

: (colon) ** 

82 

072 

01 

A 

12 1 

61 

A 

12-1 

101 

02 

B 

12-2 

62 

B 

12-2 

102 

03 

C 

12 3 

63 

C 

12-3 

103 

04 

D 

12-4 

64 

D 

12-4 

104 

05 

E 

12-5 

65 

E 

12-5 

105 

06 

F 

12-6 

66 

F 

12-6 

106 

07 

G 

12-7 

67 

G 

12-7 

107 

10 

H 

12-8 

70 

H 

12-8 

110 

11 

1 

12-9 

71 

1 

12-9 

111 

12 

J 

11-1 

41 

J 

11-1 

112 

13 

K 

11-2 

42 

< 

11-2 

113 

14 

L 

11-3 

43 

L 

11-3 

114 

15 

M 

11-4 

44 

M 

11-4 

115 

16 

N 

11-5 

45 

N 

11-5 

116 

17 

O 

11-6 

46 

O 

11-6 

117 

20 

P 

11-7 

47 

P 

117 

120 

21 

Q 

11-8 

50 

0 

11-8 

121 

22 

R 

11-9 

51 

R 

119 

122 

23 

S 

0-2 

22 

S 

0-2 

123 

24 

T 

0-3 

23 

T 

0-3 

124 

25 

U 

0-4 

24 

U 

04 

125 

26 

V 

05 

25 

V 

05 

126 

27 

w 

06 

26 

w 

0-6 

127 

30 

X 

0-7 

27 

X 

0-7 

130 

31 

V 

0-8 

30 

Y 

0-8 

131 

32 

z 

0-9 

31 

z 

0-9 

132 

33 

0 

0 

12 

0 

0 

060 

34 


1 

01 

1 

1 

061 

35 

2 

2 

02 

2 

2 

062 

36 

3 

3 

03 

3 

3 

063 

37 

4 

4 

04 

4 

4 

064 

40 

5 

5 

05 

5 

5 

065 

41 

6 

6 

06 

6 

6 

066 

42 

7 

7 

07 

7 

7 

067 

43 

8 

8 

10 

8 

8 

070 

44 

9 

9 

11 

9 

9 

071 

45 

+ 

12 

60 

+ 

12-8-6 

053 

46 

“ 

11 

40 


11 

055 

47 


11-8-4 

54 


11 8-4 

052 

50 

/ 

0-1 

21 

/ 

0-t 

057 

51 

< 

084 

34 


12-8-5 

050 

52 

) 

12-8-4 

74 

) 

11-8-5 

051 

53 

S 

11-8-3 

53 

S 

11-83 

044 

54 

= 

8 3 

13 

- 

8 6 

075 

55 

blank 

no punch 

20 

blank 

no punch 

040 

56 

, (comma) 

0-8-3 

33 

, (comma) 

08 3 

054 

57 

. (period) 

12-8-3 

73 

. (period) 

12 8 3 

056 

60 

- 

0-8-6 

36 

# 

8-3 

043 

61 

[ 

8 7 

17 

C 

12-8-2 

133 

62 

] 

%** 

0-8 2 

32 

3 

11-8-2 

135 

63 

8-6 

16 

% ** 

0-8-4 

045 

64 

X 

8-4 

14 

" (quote) 

8 7 

042 

65 

1— 

0-8 5 

35 

(underline) 

08-5 

137 

66 

V 

11-0 

52 

! 

12-8-7 

041 

67 

A 

0-8-7 

37 

& 

12 

046 

70 


11-8-5 

55 

1 (apostrophe) 

8-5 

047 

71 

J 

11-8-6 

56 

7 

0-8-7 

077 

72 

< 

12-0 

72 

< 

12-8-4 

074 

73 

> 

11-8-7 

57 

> 

0-8-6 

076 

74 

< 

8-5 

15 


8-4 

100 

75 

> 

12 8 5 

75 

\ 

0-8-2 

134 

76 

-1 

12-86 

76 

/ “' (circumflex) 

11-8-7 

136 

77 

; (semicolon) 

128-7 

77 

; (semicolon) 

11-8-6 

073 


^Twelve zero bits at the end of a 60-bit word in a zero byte record are an end of record mark rather than 
two colons. 

**ln installations using a 63-graphic set, display code 00 has no associated graphic or card code; display 
code 63 is the colon (8 2 punch}. The % graphic and related card codes do not exist and translations 
yield a blank (55g). 
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Collating 

Sequence 

Decimal/Octal 

CDC 

Graphic 

Display 

Code 

External 

BCD 

Collating 

Sequence 

Decimal/Octal 

CDC 

Graphic 

Display 

Code 

External 

BCD 

00 

00 

blank 

55 

20 

32 

40 

H 

10 

— 

01 

01 

< 

74 

15 

33 

41 


11 

■I 

02 

02 

% 

63 t 

16 t 

34 

42 

V 

66 


03 

03 


61 

17 

35 

43 

J 

12 

WbM 

04 

04 

— 

65 

35 

36 

44 

K 

13 

42 

05 

05 


60 

36 

37 

45 

L 

14 

43 

06 

06 

A 

67 

37 

38 

46 

M 

15 

44 

07 

07 

t 

70 

55 

39 

47 

N 

16 

45 

08 

10 

1 

71 

56 

40 

50 

O 

17 

46 

09 

11 

> 

73 

57 

41 

51 

P 

20 

47 

10 

12 

> 

75 

75 

42 

52 

Q 

21 

50 

11 

13 

—1 

76 

76 

43 

53 

R 

22 

51 

12 

14 

. 

57 

73 

44 

54 

] 

62 

32 

13 

15 

) 

52 

74 

45 

55 

S 

23 

22 

14 

16 


77 

77 

46 

56 

T 

24 

23 

15 

17 

+ 

45 

60 

47 

57 

U 

25 

24 

16 

20 

$ 

53 

53 

48 

60 

V 

26 

25 

17 

21 

• 

47 

54 

49 

61 

w 

27 

26 

18 

22 

- 

46 

40 

50 

62 

X 

30 

27 

19 

23 

/ 

50 

21 

51 

63 

Y 

31 

30 

20 

24 

9 

56 

33 

52 

64 

z 

32 

31 

21 

25 

( 

51 

34 

53 

65 

* 

00 + 

nonet 

22 

26 

= 

54 

13 

54 

66 

0 

33 

12 

23 

27 

* 

64 

14 

55 

67 

1 

34 

01 

24 

30 

< 

72 

72 

56 

70 

2 

35 

02 

25 

31 

A 

01 

61 

57 

71 

3 

36 

03 

26 

32 

B 

02 

62 

58 

72 

4 

37 

04 

27 

33 

C 

03 

63 

59 

73 

5 

40 

05 

28 

34 

D 

04 

64 

60 

74 

6 

41 

06 

29 

35 

E 

05 

65 

61 

75 

7 

42 

07 

30 

36 

F 

06 

66 

62 

76 

8 

43 

10 

31 

37 

G 

07 

67 

63 

77 

9 

44 

11 


^ln installations using the 63-graphic set, the % graphic does not exist. The : graphic is display code 63, 
External BCD code 16. 
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TABLE A-3. ASCII CHARACTER SET COLLATING SEQUENCE 


Collating ASCII 

Sequence Graphic 

Decimal/Octal Subset 



ay ASCII 
e Code 


Collating 

Sequence 

Decimal/Octal 



ay ASCII 
e Code 



Tin installations using a 63-graphic set, the % graphic does not exist. The : graphic 
is display code 63. 
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GLOSSARY 


B 


Alphanumeric - 

The description of a data item that can be any 
character A through Z, digit 0 through 9, or 
special character recognized by Query Update. 

Area - 

A uniquely named data base subdivision that 
contains data records; a file. 

Beginning-of-Information - 

The start of the first user record in a file. 

Break - 

The point during preparation of a report page 
when headings and/or footings are to be in¬ 
serted. 


Character Set - 

Set of graphic and/or control characters. 

Code Set - 

System of symbols used to represent each char¬ 
acter within a character set. 

Condition - 

One of a set of specified values for which a 
data item can be tested. 

Current Catalog - 

The catalog (default or permanent) that is 
available for recording Query Update trans¬ 
missions. 

CYBER Record Manager (CRM) - 

A software package running under the NOS and 
NOS/BE operating systems that allows a variety 
of record types, blocking types, and file 
organizations to be created and accessed. All 
CYBER Record Manager file processing requests 
ultimately pass through the operating system 
input/output routines. 


Data Administrator - 

The person, or group of people, that lead the 
design, programming, implementation, and main¬ 
tenance efforts associated with a DMS-170 
controlled data base. 

Data Base File - 

A file whose organization and content is de¬ 
scribed by one or more subschemas. 

Data Description Language (DDL) - 

The language used to generate a subschema. 

Default Catalog - 

A local file (ZZZZZQ2) that is available for 
recording Query Update transmissions. 

Delimiter - 

One of a set of characters used to separate and 
organize data items; synonymous with separator. 


Directive - 

A Query Update statement that describes an 
operation to be performed. A directive con¬ 
sists of a reserved word in the Query Update 
language and a combination of recognized sym¬ 
bols, punctuation, and user—supplied elements. 

Directory - 

A file that contains area and record attributes. 
The permanent file directory (subschema) for a 
data base file is created by DDL; the temporary 
file directory for a data base file is created 
by an EXTRACT or DISPLAY UPON (directory not 
generated on NOS 1) directive. The temporary 
file directory for a non-data-base file is 
created by a DESCRIBE or DISPLAY UPON (direc¬ 
tory not generated on NOS 1) directive. 

File Organization — 

The predetermined arrangement of stored data. 
CYBER Record Manager recognizes the following 
organizations: sequential, extended indexed 

sequential, extended actual key, extended 
direct access, initial indexed sequential, 
initial actual key, and initial direct access. 

Footing - 

Lines of print that comprise a caption and 
occur after a break. 

Heading - 

Lines of print that comprise a caption and 
occur after a break. 

Index File - 

A file that contains an entry for each unique 
value of alternate key and associates it with a 
list of primary keys for all records containing 
that value. 

Key - 

One or more data items, the contents of which 
identify a record or set of records. 

Layout Directives - 

Directives that supply arrangement and struc¬ 
ture of a report on a printed page. 

Logical Operator - 

A word defining the logical connections between 
two terms. Query Update recognizes AND, OR, 
XOR, and NOT. 

Non-Data-Base File - 

A sequential file whose organization and con¬ 
tent is not described by a subschema. 

Numeric - 

The description of a data item that can be any 
digit 0 through 9. 

Permanent Catalog - 

A permanent file that contains recorded Query 
Update transmissions. 
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Permanent File - 

A disk file known to the system because the 
file name has been cataloged in a permanent 
file table. 

Picture - 

The description of the general characteristics 
and editing requirements of a data item. 

Record - 

CYBER Record Manager defines a record as a 
group of related characters. A record or a 
portion of a record is the smallest collection 
of information passed between CYBER Record 
Manager and a user program. 

Register - 

Query Update locations that retain current data 
for display purposes. 

Relation - 

The logical structure formed by the joining of 
records. 

Relational Operator - 

An abbreviation or correspondence symbol that 
is used to describe a relationship between two 
terms. Query Update recognizes EQ, NE, GT, LT, 
GE, and LE. 

Report Information Table - 

An internal table that is generated by Query 
Update and used to produce a report. 

Reserved Word - 

The first word of a Query Update directive. 


Separator - 

A character used by Query Update as a delimiter. 
Session - 

Series of transmissions sent by a user between 
the QU control statement and the END directive. 

Session Id - 

The six-character session name assigned by the 
user. 

Subschema — 

Plan or outline described with DDL statements 
regarding names and characteristics of data 
items, records, areas, and relationships that 
must be maintained among data base elements. 

Subscripting - 

Use of an integer or variable to identify a 
particular element in an array. 

Temporary Data Item - 

An item established through a DEFINE, DESCRIBE, 
or SPECIFY directive for temporary use with a 
data base or non-data-base file. 

Transmission - 

One or more directives submitted as a unit. 
Transmission Id - 

The three-digit system-supplied identifier 
assigned to one or more directives in a session 
catalog. 


• B-2 
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ACCESS/HITS message 3-7 
Adding a directive 6-10 
Alphanumeric 

Definition B-l 
Fields 3-2 

ALTER directive 2-2, 6-4, 6-10 
Altering reports 6-10 
Ambiguities 7-7 
Area 3-1, B-l 
Arithmetic operations 7-3 


Beglnning-of-Information (BOI) B-l 
Break B-l 

BREAK directive 2-2, 6-16 


CATALOG control statement 3-2, 6-1 

Catalog of directives 6-3 

Cataloging reports 6-4 

Character sets A-l, B-l 

COBOL 1-1 

Code set B-l 

Column headings 6-14 

COMPILE directive 2-2, 6-23 

Condition B-l 

Conditional 

Delete 3-7 
Display 3-5 
Modification 3-7 
Query 3-4 

Continuation characters 2-7 
Continuing display 3-5 
Control statements 
ATTACH 4-1 
CATALOG 3-2, 6-1 
COPY 6-1 
DDL 3-1 

DEFINE 3-1, 6-1 
FILE 4-1 
QU 2-8 
REPORT 6-24 
REQUEST 3-2 
ROUTE 6-1 

COPY control statement 6-1 
CREATE directive 2-2, 3-2 
Current catalog B-l 
Current date 6-10 

CYBER Record Manager (CRM) 2-9, B-l 


Data administrator 1-1, B-l 
Data base file 

Definition 2-1, B-l 
File operations 3-1 
Modification 3-4 
Query 3-4 

Data Description Language (DDL) 
Control statement 3-1 
Language 1-1, 2-1, B-l 
DATE directive 2-2, 6-10 
Default catalog 

Definition 6-3, B-l 
Storing 6-3 
Default display 3-6 


DEFINE control statement 3-1, 6-1 
DEFINE directive 2-2, 3-1 
Delimiter B-l 
DESCRIBE directive 2-2, 4-1 
DETAIL directive 2-2, 6-2 
DIAGNOSTIC directive 2-2, 8-1 
Directives 

Alphabetic listing 2-2 
ALTER 2-2, 6-10 
BREAK 2-2, 6-16 
COMPILE 2-2, 6-23 
CREATE 2-2, 3-2, 3-3 
DATE 2-2, 6-10 
DEFINE 2-2, 6-14 
Definition 2-1, B-l 
DESCRIBE 2-2, 4-1 
DETAIL 2-2, 6-2 
DIAGNOSTIC 2-2, 8-1 
DISPLAY 2-3, 3-5 
DISPLAY FROM 4-2 
DISPLAY UPON 4-2 
DUPLICATE 2-3, 6-8 
END 2-3, 3-3 
ERASE 2-3, 6-11 
EVALUATE 2-3, 6-14 
EXECUTE 2-3 
EXHIBIT 2-3, 8-1 
EXTRACT 2-3, 6-2 
FOOTING 2-4, 7-4 
FORMAT 2-4, 6-2 
HEADING 2-4, 6-16 
HELP 2-4, 8-1, 8-3 
IF 2-4, 3-5 
INVOKE 2-4, 3-4 
MODIFY 2-4, 3-4 
MODIFY FROM 5-1 
MOVE 2-4, 7-4 
NOTE 2-5, 8-1, 8-4 
OS 2-5, 4-1 
PAGE-NUMBER 2-5, 6-16 
PAGE-SIZE 2-5, 6-19 
PERFORM 2-5, 6-4, 6-6 
PREFACE 2-5, 6-21 
PREPARE 2-5, 6-2 
PREVIEW 2-5, 6-22 
RECAP 2-5, 6-19 
RECORDING 2-5, 6-5 
REMOVE 2-5, 3-7 
REMOVE FROM 5-3 
RETURN 2-6, 7-1, 7-2 
REWIND 2-6, 5-1 
SELECT 2-6, 6-15 
SEPARATOR 2-6, 4-2 
SORT 2-6, 6-12 
SPECIFY 2-6, 6-15 
STORE 2-6, 3-3 
STORE FROM 5-3 
SUMMARY 2-6, 6-21 
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